'
```
## 访问“干净的”数据
#### `Form.cleaned_data`
[`Form`](#django.forms.Form) 类中的每个字段不仅负责验证数据，还负责“清理”数据——将其规范为一致的格式。这是一个很好的功能，因为它允许以各种方式输入特定字段的数据，并总是产生一致的输出。
例如， [`DateField`](/zh-hans/4.1/ref/forms/fields/#django.forms.DateField) 将输入规范化为 Python 的 `datetime.date` 对象。无论你传递给它的是格式为 `'1994-07-15'` 的字符串，还是 `datetime.date` 对象，或者其他一些格式，只要它是有效的，`DateField` 都会将它规范化为 `datetime.date` 对象。
当你用一组数据创建了一个 [`Form`](#django.forms.Form) 实例并对其进行验证后，你就可以通过它的 `cleaned_data` 属性来访问干净的数据：
```
>>> 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` 字典只包含有效字段：
```
>>> 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` 只包含了表单的字段：
```
>>> 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` 包含了它，并使用一个空值：
```
>>> 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.1/ref/forms/validation/)。
## 将表单输出为 HTML
`Form` 对象的第二个任务是将其本身渲染为 HTML。为此，`print` 对象：
```
>>> f = ContactForm()
>>> print(f)
| |
|---|
| |
|---|
| |
|---|
| |
|---|
```
如果表单与数据绑定，HTML 输出将适当地包含该数据。例如，如果一个字段用 `
` 表示，数据将在 `value` 属性中。如果一个字段用 `
` 表示，那么 HTML 将适当地包括 `checked`：
```
>>> 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 `