'
```
## 访问“干净的”数据
#### `Form.cleaned_data`
[`Form`](#django.forms.Form) 类中的每个字段不仅负责验证数据，还负责“清理”数据——将其规范为一致的格式。这是一个很好的功能，因为它允许以各种方式输入特定字段的数据，并总是产生一致的输出。
例如， [`DateField`](/zh-hans/4.2/ref/forms/fields/#django.forms.DateField) 将输入规范化为 Python 的 `datetime.date` 对象。无论你传递给它的是格式为 `'1994-07-15'` 的字符串，还是 `datetime.date` 对象，或者其他一些格式，只要它是有效的，`DateField` 都会将它规范化为 `datetime.date` 对象。
一旦你创建了一个带有一组数据并进行了验证的 [`Form`](#django.forms.Form) 实例，你可以通过它的 `cleaned_data` 属性访问清洁后的数据：
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}
```
请注意，任何基于文本的字段——如 `CharField` 或 `EmailField`——总是将输入清理成一个字符串。我们将在本文档后面介绍编码的含义。
如果你的数据验证不通过，`cleaned_data` 字典仅包含有效的字段：
```pycon
>>> data = {
... "subject": "",
... "message": "Hi there",
... "sender": "invalid email address",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> f.is_valid()
False
>>> f.cleaned_data
{'cc_myself': True, 'message': 'Hi there'}
```
`cleaned_data` 将始终仅包含在 `Form` 中定义的字段的键，即使在定义 `Form` 时传递了额外的数据。在这个例子中，我们在 `ContactForm` 构造函数中传递了许多额外字段，但 `cleaned_data` 仅包含表单的字段：
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... "extra_field_1": "foo",
... "extra_field_2": "bar",
... "extra_field_3": "baz",
... }
>>> f = ContactForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data # Doesn't contain extra_field_1, etc.
{'cc_myself': True, 'message': 'Hi there', 'sender': 'foo@example.com', 'subject': 'hello'}
```
当 `Form` 有效时，即使数据中没有为一些可选字段提供值，`cleaned_data` 也会包括所有字段的键和值。在这个例子中，数据字典没有包含 `nick_name` 字段的值，但 `cleaned_data` 包括它，并带有一个空值：
```pycon
>>> from django import forms
>>> class OptionalPersonForm(forms.Form):
... first_name = forms.CharField()
... last_name = forms.CharField()
... nick_name = forms.CharField(required=False)
...
>>> data = {"first_name": "John", "last_name": "Lennon"}
>>> f = OptionalPersonForm(data)
>>> f.is_valid()
True
>>> f.cleaned_data
{'nick_name': '', 'first_name': 'John', 'last_name': 'Lennon'}
```
在上面这个例子中，`nick_name` 的 `cleaned_data` 值被设置为一个空字符串，因为 `nick_name` 是 `CharField`，而 `CharField` 将空值视为空字符串。每个字段类型都知道它的“空”值是什么——例如，对于 `DateField`，它是 `None` 而不是空字符串。关于每个字段在这种情况下的行为的全部细节，请参阅下面“内置 `Field` 类”一节中每个字段的“空值”说明。
你可以编写代码来对特定的表单字段（基于其名称）或整个表单（考虑各种字段的组合）进行验证。更多关于这方面的信息请参见 [表单和字段验证](/zh-hans/4.2/ref/forms/validation/)。
## 将表单输出为 HTML
一个 `Form` 对象的第二个任务是将自己呈现为 HTML。要做到这一点，只需将它打印出来：
```pycon
>>> f = ContactForm()
>>> print(f)
| |
|---|
| |
|---|
| |
|---|
| |
|---|
```
如果表单与数据绑定，HTML 输出将适当地包含该数据。例如，如果一个字段由 `
` 表示，数据将位于 `value` 属性中。如果一个字段由 `
` 表示，那么 HTML 中将包含 checked\`\`（如果适用）：
```pycon
>>> data = {
... "subject": "hello",
... "message": "Hi there",
... "sender": "foo@example.com",
... "cc_myself": True,
... }
>>> f = ContactForm(data)
>>> print(f)
| |
|---|
| |
|---|
| |
|---|
| |
|---|
```
这个默认输出是一个两列的 HTML 表单，每个字段都有一个 `
`。请注意以下几点：
- 为灵活起见，输出 *不* 包括 `` 标签，也不包括 `` 标签或 `` 标签。这是你的工作。
- 每个字段类型都有一个默认的 HTML 表示。`CharField` 用 `` 表示，`EmailField` 用 `` 表示。`BooleanField(null=False)` 由一个 ``。请注意，这些只是合理的默认值；你可以通过使用部件来指定一个给定字段使用的 HTML，我们将在后面解释。
- 每个标签的 HTML `name` 直接从 `ContactForm` 类中的属性名中提取。
- 每个字段的文本标签——例如 `'Subject:'`、`'Message:'` 和 `'Cc myself:'`，是根据字段名将所有下划线转换为空格并将第一个字母大写而产生的。同样，请注意这些只是合理的默认值；你也可以手动指定标签。
- 每个文本标签都被一个 HTML `