本文档包含了Django提供的全部模型字段的字段选项 和 字段类型的API参考。
请看:
如果内建的字段不能满足你的需要，你可以尝试包含对特定国家和文化有帮助的配套代码的 django-localflavor。当然，你也可以很容易的编写你自定义的字段。
注意
严格意义上来讲， Model 是定义在django.db.models.fields里面，但为了使用方便，它们被导入到 django.db.models中；标准上，我们导入from django.db import models，然后使用 models.<Foo>Field的形式使用字段。
下列参数是全部字段类型都可用的，而且都是可选择的。
如果为True，Django将在数据库中将空值存储为NULL。默认值是 False。
字符串字段例如CharField 和TextField 要避免使用null，因为空字符串值将始终储存为空字符串而不是NULL。如果字符串字段的null=True，那意味着对于“无数据”有两个可能的值：NULL 和空字符串。在大多数情况下，对于“无数据”声明两个值是赘余的，Django 的惯例是使用空字符串而不是NULL。
无论是字符串字段还是非字符串字段，如果你希望在表单中允许空值，你将还需要设置blank=True，因为null 仅仅影响数据库存储（参见blank）。
注意
在使用Oracle 数据库时，数据库将存储NULL 来表示空字符串，而与这个属性无关。
如果你希望BooleanField 接受null 值，请用 NullBooleanField 代替。
如果为True，则该字段允许为空白。 默认值是 False。
注意它与null不同。null 纯粹是数据库范畴的概念，而blank 是数据验证范畴的。如果字段设置blank=True，表单验证时将允许输入空值。如果字段设置blank=False，则该字段为必填。
它是一个可迭代的结构(比如，列表或是元组)，由可迭代的二元组组成(比如[(A, B), (A, B) ...])，用来给这个字段提供选择项。如果设置了 choices ，默认表格样式就会显示选择框，而不是标准的文本框，而且这个选择框的选项就是 choices 中的元组。
每个元组中的第一个元素，是存储在数据库中的值；第二个元素是该选项更易理解的描述。 比如:
YEAR_IN_SCHOOL_CHOICES = (
('FR', 'Freshman'),
('SO', 'Sophomore'),
('JR', 'Junior'),
('SR', 'Senior'),
)
一般来说，最好在模型类内部定义choices，然后再给每个值定义一个合适名字的常量。
from django.db import models
class Student(models.Model):
FRESHMAN = 'FR'
SOPHOMORE = 'SO'
JUNIOR = 'JR'
SENIOR = 'SR'
YEAR_IN_SCHOOL_CHOICES = (
(FRESHMAN, 'Freshman'),
(SOPHOMORE, 'Sophomore'),
(JUNIOR, 'Junior'),
(SENIOR, 'Senior'),
)
year_in_school = models.CharField(max_length=2,
choices=YEAR_IN_SCHOOL_CHOICES,
default=FRESHMAN)
def is_upperclass(self):
return self.year_in_school in (self.JUNIOR, self.SENIOR)
尽管你可以在模型类的外部定义choices然后引用它，但是在模型类中定义choices和其每个choice的name(即元组的第二个元素)可以保存所有使用choices的类的信息， 也使得choices更容易被应用（例如， Student.SOPHOMORE 可以在任何引入Student 模型的位置生效)。
你也可以归类可选的choices到已命名的组中用来达成组织整理的目的:
MEDIA_CHOICES = (
('Audio', (
('vinyl', 'Vinyl'),
('cd', 'CD'),
)
),
('Video', (
('vhs', 'VHS Tape'),
('dvd', 'DVD'),
)
),
('unknown', 'Unknown'),
)
每个元组的第一个元素是组的名字。第二个元素是一组可迭代的二元元组，每一个二元元组包含一个值和一个给人看的名字构成一个选项。分组的选项可能会和未分组的选项合在同一个list中。 （就像例中的unknown选项）。
对于有choices set的模型字段, Django 将会加入一个方法来获取当前字段值的易于理解的名称(即元组的第二个值)参见数据库API文档中的get_FOO_display()。
请注意choices可以是任何可迭代的对象 – 不是必须是列表或者元组。这一点使你可以动态的构建choices。但是如果你发现你自己搞不定动态的choices，你最好还是使用ForeignKey来构建一个合适的数据库表。如果有数据变动的话，choices意味着那些变动不多的静态数据。
除非blank=False 和default一起在字段中被设置，否则，可选择菜单将会有"---------" 的标签。要重写这个行为, 需要加入一个包含None的元组到 choices里面; 例如 (None, 'Your String For Display'). 或者, 你可以在操作有意义的地方用一个空字符串代替None - 比如在一个 CharField.
数据库中用来表示该字段的名称。如果未指定，那么Django将会使用Field名作为字段名.
如果你的数据库列名为SQL语句的保留字，或者是包含不能作为Python 变量名的字符，如连字符，没问题。Django 会在后台给列名和表名加上双引号。
若值为 True, 则 django-admin sqlindexes 将会为此字段输出 CREATE INDEX 语句。（译注：为此字段创建索引）
如果该字段有索引的话，数据库表空间的名称将作为该字段的索引名。如果DEFAULT_INDEX_TABLESPACE 已经设置，则默认值是由DEFAULT_INDEX_TABLESPACE指定, 如果没有设置则由 db_tablespace 指定，如果后台数据库不支持表空间，或者索引，则该选项被忽略
该字段的默认值. 它可以是一个值或者一个可调用对象. 如果是一个可调用对象，那么在每一次创建新对象的时候，它将会调用一次.
这个默认值不可以是一个可变对象（如字典，列表，等等）,因为对于所有模型的一个新的实例来说，它们指向同一个引用。或者，把他们包装为一个可调用的对象。例如，你有一个自定义的JSONField，并且想指定一个特定的字典值，可以如下使用：
def contact_default():
return {"email": "[email protected]"}
contact_info = JSONField("ContactInfo", default=contact_default)
请注意lambdas 函数不可作为如 default 这类可选参数的值.因为它们无法被 migrations命令序列化. 请参见文档其他部分。
默认值会在新实例创建并且没有给该字段提供值时使用。如果字段为主键，默认值也会在设置为None时使用。
之前的版本不会使用None作为主键
error_messages 参数能够让你重写默认抛出的错误信息。通过指定 key 来确认你要重写的错误信息。
error_messages 的 key 值包括 null, blank, invalid, invalid_choice, unique, 和 unique_for_date. 其余的 error_messages 的 keys 在不同的章节下 Field types是不一样的。
这个 unique_for_date 的 error_messages 的key 是在 1.7 中加的。
额外的 ‘help' 文本将被显示在表单控件form中。即便你的字段没有应用到一个form里面，这样的操作对文档化也很有帮助。
注意这 不 会自动添加 HTML 标签。需要你在 help_text 包含自己需要的格式。例如:
help_text="Please use the following format: <em>YYYY-MM-DD</em>."
另外, 你可以使用简单文本和django.utils.html.escape()以避免任何HTML特定的字符.请确保你所使用的help text能够避免那些由不受信任的用户进行的跨站点脚本攻击。
若为 True, 则该字段会成为模型的主键字段。
如果你没有在模型的任何字段上指定 primary_key=True, Django会自动添加一个 AutoField 字段来充当主键。 所以除非你想要覆盖默认的主键行为，否则不需要在任何字段上设定primary_key=True 。更多内容 请参考 Automatic primary key fields.
primary_key=True 暗含着null=False 和unique=True. 一个对象上只能拥有一个主键.
主键字段是只读的。如果你改变了一个已存在对象上的主键并且保存的话，会创建一个新的对象，而不是覆盖旧的.
如果为 True, 这个字段在表中必须有唯一值.
这是一个在数据库级别的强制性动作,并且通过模型来验证。如果你试图用一个重复的值来保存unique 字段，那么一个django.db.IntegrityError就会通过模型的save() 函数抛出来。
除了ManyToManyField、OneToOneField和FileField 以外的其他字段类型都可以使用这个设置。
注意当设置unique 为True 时，你不需要再指定 db_index，因为unique 本身就意味着一个索引的创建。
当设置它为DateField 和DateTimeField 字段的名称时，表示要求该字段对于相应的日期字段值是唯一的。
例如，你有一个title 字段设置unique_for_date="pub_date"，那么Django 将不允许两个记录具有相同的title 和pub_date。
注意，如果你将它设置为DateTimeField，只会考虑其日期部分。此外，如果USE_TZ 为True，检查将以对象保存时的当前的时区 进行。
这是在模型验证期间通过Model.validate_unique() 强制执行的，而不是在数据库层级进行验证。如果unique_for_date 约束涉及的字段不是ModelForm中的字段（例如，exclude中列出的字段或者设置了editable=False），Model.validate_unique() 将忽略该特殊的约束。
一个字段的可读性更高的名称。如果用户没有设定冗余名称字段，Django会自动将该字段属性名中的下划线转换为空格，并用它来创建冗余名称。可以参照 Verbose field names.
一个根据实际ID自动增长的IntegerField . 你通常不需要直接使用;如果不指定,一个主键字段将自动添加到你创建的模型中.详细查看 主键字段.
一个64位整数, 类似于一个 IntegerField ,它的值的范围是 -9223372036854775808 到9223372036854775807之间. 这个字段默认的表单组件是一个TextInput.
这是一个用来存储原始二进制码的Field. 只支持bytes 赋值，注意这个Field只有很有限的功能。例如，不大可能在一个BinaryField 值的数据上进行查询
滥用BinaryField
尽管你可能想使用数据库来存储你的文件，但是99%的情况下这都是不好的设计。这个字段 不是替代static files 的合理操作.
true/false 字段。
此字段的默认表单挂件是一个CheckboxInput.
如果你需要设置null 值，则使用NullBooleanField 来代替BooleanField。
如果Field.default没有指定的话， BooleanField 的默认值是 None。
一个用来存储从小到很大各种长度的字符串的地方
如果是巨大的文本类型, 可以用 TextField.
这个字段默认的表单样式是 TextInput.
CharField必须接收一个额外的参数:
字段的最大字符长度.max_length将在数据库层和Django表单验证中起作用, 用来限定字段的长度.
注意
如果你在写一个需要导出到多个不同数据库后端的应用，你需要注意某些后端对max_length有一些限制，查看数据库后端注意事项来获取更多的细节
MySQL的使用者们:
如果你在使用该字段的同时使用MySQLdb 1.2.2以及 utf8_bin 校对 其一般不是 默认情况), 你必须了解一些问题. 详细请参考 MySQL database notes .
一个逗号分隔的整数字段。像 CharField一样， 需要一个max_length 参数， 同时数据库移植时也需要注意。
这是一个使用Python的datetime.date实例表示的日期. 有几个额外的设置参数:
每次保存对象时，自动设置该字段为当前时间。用于"最后一次修改"的时间戳。注意，它总是使用当前日期；它不只是一个默认值，你可以覆盖。
当对象第一次被创建时自动设置当前时间。用于创建时间的时间戳. 它总是使用当前日期；和你可以覆盖的那种默认值不一样。
该字段默认对应的表单控件是一个TextInput. 在管理员站点添加了一个JavaScript写的日历控件，和一个“Today"的快捷按钮.包含了一个额外的invalid_date错误消息键.
auto_now_add, auto_now, and default 这些设置是相互排斥的. 他们之间的任何组合将会发生错误的结果.
注意
在目前的实现中，设置auto_now或者auto_now_add为True将为让这个字段同时得到editable=False和blank=True这两个设置.
注意
auto_now and auto_now_add这两个设置会在对象创建或更新的时刻,总是使用default timezone(默认时区)的日期. 如果你不想这样，你可以考虑一下简单地使用你自己的默认调用或者重写save()(在save()函数里自己添加保存时间的机制.译者注)而不是使用auto_now 或者 auto_now_add;也可以使用DateTimeField字段类来替换DateField 并且在给用户呈现时间的时候,决定如何处理从datetime到date的转换.
它是通过Python datetime.datetime实例表示的日期和时间. 携带了跟DateField一样的额外参数.
该字段默认对应的表单控件是一个单个的TextInput(单文本输入框). 管理界面是使用两个带有 JavaScript控件的 TextInput 文本框.
用python中 Decimal 的一个实例来表示十进制浮点数. 有两个 必须的参数:
位数总数，包括小数点后的位数。该值必须大于等于decimal_places.
小数点后的数字数量
例如,要保存最大为 999 并有两位小数的数字,你应该使用:
models.DecimalField(..., max_digits=5, decimal_places=2)
而要存储那些将近10亿，并且要求达到小数点后十位精度的数字:
models.DecimalField(..., max_digits=19, decimal_places=10)
该字段默认的窗体组件是 TextInput.
注意
想获取更多关于 FloatField 和 DecimalField 差异, 请参照 FloatField vs. DecimalField.
用作存储一段时间的字段类型 - 类似Python中的timedelta. 当数据库使用的是PostgreSQL, 该数据类型使用的是一个 interval 而在Oracle上，则使用的是 INTERVAL DAY(9) TO SECOND(6). 否则使用微秒的bigint。
注意
DurationField 的算数运算在多数情况下可以很好的工作。 然而，在除了PostgreSQL之外的其他数据库中, 将 DurationField 与 DateTimeField 的实例比较则不会得到正确的结果。
一个 CharField 用来检查输入的email地址是否合法。它使用 EmailValidator 来验证输入合法性。
默认最大长度 max_length 从75增加到254以符合RFC3696/5321标准。
一个上传文件的字段。
注意
FileField字段不支持primary_key 和unique参数，如果使用会生成 TypeError错误
有两个可选参数：
在旧版本Django中，upload_to 属性是必须要有的;
一个本地文件系统的路径，它将附加到MEDIA_ROOT 设置的后面来确定url 属性的值。
这个路径可能会包含一个 strftime() 格式串,并且会在文件上传时被替换为 实际的date/time作为文件路径 (这样上传的文件就不会塞满你指定的文件夹了).
它还可以是一个可调用对象如函数，将调用它来获取上传路径，包括文件名。这个可调用对象必须接受两个参数，并且返回一个Unix 风格的路径（带有前向/）给存储系统。将传递的两个参数为：
| Argument | Description |
|---|---|
| instance | FileField 定义所在的模型的实例。更准确地说，就是当前文件的所在的那个实例。 大部分情况下，这个实例将还没有保存到数据库中，若它用到默认的AutoField 字段，它的主键字段还可能没有值。 |
| filename | The filename that was originally given to the file. This may or may not be taken into account when determining the final destination path. |
这个字段的默认表单Widget 是ClearableFileInput。
在模型中调用FileField 或 ImageField (见下方) 需如下几步：
例如，如果你的 MEDIA_ROOT设定为 '/home/media'，并且 upload_to设定为 'photos/%Y/%m/%d'。 upload_to的'%Y/%m/%d'被strftime()所格式化；'%Y' 将会被格式化为一个四位数的年份, '%m' 被格式化为一个两位数的月份'%d'是两位数日份。如果你在Jan.15.2007上传了一个文件，它将被保存在/home/media/photos/2007/01/15目录下.
如果你想获得上传文件的存盘文件名，或者是文件大小，你可以分别使用 name 和 size 属性； 更多可用属性及方法信息，请参见 File 类索引 和 Managing files 主题指导.
注意
保存的文件作为模型存储在数据库中的一部分，所以在磁盘上使用的实际的文件名在模型保存完毕之前是不可靠的。
上传的文件对应的URL可以通过使用 url 属性获得. 在内部，它会调用 Storage 类下的url()方法.
值得注意的是，无论你在任何时候处理上传文件的需求，你都应该密切关注你的文件将被上传到哪里，上传的文件类型，以避免安全漏洞。认证所有上传文件 以确保那些上传的文件是你所认为的文件。例如，如果你盲目的允许其他人在无需认证的情况下上传文件至你的web服务器的root目录中，那么别人可以上传一个CGI或者PHP脚本然后通过访问一个你网站的URL来执行这个脚本。所以，不要允许这种事情发生。
甚至是上传HTML文件也值得注意，它可以通过浏览器（虽然不是服务器）执行，也可以引发相当于是XSS或者CSRF攻击的安全威胁。
FileField 实例将会在你的数据库中创建一个默认最大长度为100字符的varchar 列。就像其他的fields一样, 你可以用 max_length 参数改变最大长度的值.
当你添加 FileField 到你的模型中时, 你实际上会获得一个 FieldFile的实例来替代将要访问的文件。 除了继承至 django.core.files.File的功能外, 这个类还有其他属性和方法可以用于访问文件:
通过潜在Storage 类的url()方法可以只读地访问文件的URL。
该方法像标准的Python open() 方法,并可通过 mode参数设置打开模式.
该方法像标准的Pythonfile.close() 方法,并关闭相关文件.
这个方法会将文件名以及文件内容传递到字段的storage类中,并将模型字段与保存好的文件关联. 如果想要手动关联文件数据到你的模型中的 FileField实例, 则save() 方法总是用来保存该数据.
方法接受两个必选参数: name 文件名, 和 content 文件内容.可选参数save 控制模型实例在关联的文件被修改时是否保存.默认为 True.
注意参数 content 应该是 django.core.files.File的一个实例, 而不是Python内建的File对象.你可以用如下方法从一个已经存在的Python文件对象来构建 File :
from django.core.files import File
# Open an existing file using Python's built-in open()
f = open('/tmp/hello.world')
myfile = File(f)
或者，你可以像下面的一样从一个python字符串中构建
from django.core.files.base import ContentFile
myfile = ContentFile("hello world")
更多信息, 请参见 Managing files.
删除与此实例关联的文件，并清除该字段的所有属性。注意︰ 如果它碰巧是开放的调用 delete() 方法 时，此方法将关闭该文件。
模型实例save的文件与此字段关联的可选 保存 参数控件已被删除。默认值为 True。
注意，model删除的时候，与之关联的文件并不会被删除。如果你要把文件也清理掉，你需要自己处理。
一个 CharField ，内容只限于文件系统内特定目录下的文件名。有三个参数, 其中第一个是 必需的:
必填。这个FilePathField 应该得到其选择的目录的绝对文件系统路径。例如: "/home/images".
可选的.FilePathField 将会作为一个正则表达式来匹配文件名。但请注意正则表达式将将被作用于基本文件名，而不是完整路径。例如: "foo.*.txt$", 将会匹配到一个名叫 foo23.txt 的文件，但不匹配到 bar.txt 或者 foo23.png.
可选的.True 或 False.默认是True.声明是否包含指定位置的文件。该参数或allow_folders 中必须有一个为 True.
是可选的.输入 True 或者 False.默认值为 False.声明是否包含指定位置的文件夹。该参数或 allow_files 中必须有一个为 True.
当然，这些参数可以同时使用。
有一点需要提醒的是 match只匹配基本文件名（base filename）, 而不是整个文件路径（full path）. 例如:
FilePathField(path="/home/images", match="foo.*", recursive=True)
...将匹配/home/images/foo.png而不是/home/images/foo/bar.png 因为只允许匹配 基本文件名(foo.png 和 bar.png).
FilePathField实例被创建在您的数据库为varchar列默认最大长度为 100 个字符。作为与其他字段，您可以更改使用的max_length最大长度。
用Python的一个float 实例来表示一个浮点数.
该字段的默认组件是一个 TextInput.
FloatField 与DecimalField
有时候FloatField 类会和DecimalField 类发生混淆. 虽然它们表示都表示实数，但是二者表示数字的方式不一样。FloatField 使用的是Python内部的 float 类型, 而DecimalField 使用的是Python的 Decimal 类型. 想要了解更多二者的差别, 可以查看Python文档中的 decimal 模块.
继承了 FileField的所有属性和方法, 但还对上传的对象进行校验，确保它是个有效的image.
除了从FileField继承来的属性外，ImageField 还有宽和 高属性。
为了更便捷的去用那些属性值, ImageField 有两个额外的可选参数
该属性的设定会在模型实例保存时,自动填充图片的高度.
该属性的设定会在模型实例保存时,自动填充图片的宽度.
ImageField字段需要调用Pillow 库.
ImageField会创建在你的数据库中 和 varchar 一样,默认最大长度为100和其他字段一样, 你可以使用max_length 参数来设置默认文件最大值.
此字段的默认表单工具是ClearableFileInput.
一个整数。在Django所支持的所有数据库中，从 -2147483648 到 2147483647 范围内的值是合法的。默认的表单输入工具是TextInput.
自1.7版起已弃用：该字段已废弃，从1.7开始支持GenericIPAddressField.
IP地址，会自动格式化（例如：“192.0.2.30”）。默认表单控件为 TextInput.
一个 IPv4 或 IPv6 地址, 字符串格式 (例如 192.0.2.30 或 2a02:42fe::4). 这个字段的默认表单小部件是一个TextInput.
IPv6地址规范化遵循 RFC 4291部分2.2，包括使用该部分第3段中建议的IPv4格式，如::ffff:192.0.2.0例如，2001:0::0:01将被归一化为2001::1和::ffff:0a0a:0a0a ::ffff:10.10.10.10。所有字符都转换为小写。
限制指定协议的有效输入。接受的值为'both'（默认值），'IPv4'或'IPv6'。匹配不区分大小写。
解析IPv4映射地址如 ::ffff:192.0.2.1.如果启用该选项，则地址将被解析到192.0.2.1.默认为禁用。只有当协议 设置为'both'时才可以使用。
如果允许空白值，则必须允许null值，因为空白值存储为null。
类似BooleanField, 但是允许 NULL 作为一个选项.使用此代替null=True的BooleanField。此字段的默认表单widget为NullBooleanSelect。
类似 IntegerField, 但值必须是正数或者零(0). 从0到2147483647的值在Django支持的所有数据库中都是安全的。由于向后兼容性原因，接受值0。
该模型字段类似 PositiveIntegerField, 但是只允许小于某一特定值（依据数据库类型而定）。从0 到 32767 这个区间，对于Django所支持的所有数据库而言都是安全的。
Slug 是一个新闻术语（通常叫做短标题）。一个slug只能包含字母、数字、下划线或者是连字符，通常用来作为短标签。通常它们是用来放在URL里的。
像CharField一样，你可以指定max_length（也请参阅该部分中的有关数据库可移植性的说明和max_length）。如果没有指定 max_length, Django将会默认长度为50。
将Field.db_index设置为True。
根据某些其他值的值自动预填充SlugField通常很有用。你可以在admin中使用prepopulated_fields自动执行此操作。
与 IntegerField这个字段类型很类似,不同的是SmallInteger类型只能在一个确定的范围内(数据库依赖)。对于django来讲，该字段值在 -32768 至 32767这个范围内对所有可支持的数据库都是安全的。
大文本字段。该模型默认的表单组件是Textarea。
如果你在这个字段类型中使用了max_length属性，它将会在渲染页面表单元素Textarea 时候体现出来。但是并不会在model或者数据库级别强制性的限定字段长度。请使用CharField。
MySQL 用户
如果你将此字段用于MySQLdb 1.2.1p2和utf8_bin排序规则（这不是默认值），则需要注意一些问题。有关详细信息，请参阅MySQL数据库注释。
时间字段，和Python中 datetime.time 一样。接受与DateField相同的自动填充选项。
表单默认为 TextInput.输入框。Admin添加一些JavaScript快捷方式。
一个CharField 类型的URL
此字段的默认表单widget为TextInput。
与所有CharField子类一样，URLField接受可选的max_length参数。如果不指定max_length，则使用默认值200。
一个用来存储UUID的字段。使用Python的UUID类。 当使用PostgreSQL数据库时，该字段类型对应的数据库中的数据类型是uuid，使用其他数据库时，数据库对应的是char(32)类型。
使用UUID类型相对于使用具有primary_key参数的AutoField类型是一个更好的解决方案。 数据库不会自动生成UUID，所以推荐使用default参数：
import uuid
from django.db import models
class MyUUIDModel(models.Model):
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
# other fields
注意：这里传递给default是一个可调用的对象（即一个省略了括号的方法），而不是传递一个UUID实例给default
Field 是一个抽象的类, 用来代表数据库中的表的一列. Django 使用这些fields 去创建表 (db_type()), 去建立Python中的类型和数据库中类型的映射关系 (get_prep_value()) 反之亦然 (from_db_value()), 并且实现Lookup API reference (get_prep_lookup()).
field 是不同Django版本API中最根本的部分，尤其是models and querysets.
在模型中，一个字段被实例化为类的属性，并表现为一个特定的表的列，详情查看Models. 它具有null和唯一等属性，以及Django用于将字段值映射到数据库特定值的方法。
字段是RegisterLookupMixin的子类，因此可以在其上注册Transform和Lookup QuerySet s（例如field_name__exact =“foo”）。默认情况下，所有内置查找都已注册。
Django的所有内建字段，如CharField都是Field的特定实现。如果您需要自定义字段，则可以将任何内置字段子类化，也可以从头开始写入字段。无论哪种情况，请参阅编写自定义模型字段。
字段的详细说明，例如用于django.contrib.admindocs应用程序。
描述可以是以下形式：
description = _("String (up to %(max_length)s)")
其中参数从字段的__ dict __插入。
要将Field映射到数据库特定类型，Django公开了两种方法：
有三种主要情况，Django需要与数据库后端和字段交互：
查询时，使用get_db_prep_value()和get_prep_value()：
value是模型属性的当前值，方法应以已准备好用作查询中的参数的格式返回数据。
有关使用方式，请参阅将Python对象转换为查询值。
将值转换为后端特定值。如果prepared = True和get_prep_value() if为False，则默认返回值。
有关用法，请参见将查询值转换为数据库值。
加载数据时，使用from_db_value()：
将数据库返回的值转换为Python对象。它与get_prep_value()相反。
此方法不用于大多数内置字段，因为数据库后端已返回正确的Python类型，或后端本身执行转换。
有关用法，请参见将值转换为Python对象。
注意
出于性能原因，from_db_value在不需要它的字段（所有Django字段）上不实现为无操作。因此，您不能在定义中调用super。
保存时，使用pre_save()和get_db_prep_save()
与get_db_prep_value()相同，但在字段值必须保存到数据库时调用。默认返回get_db_prep_value()。
在get_db_prep_save()之前调用方法以在保存之前准备值（例如，对于DateField.auto_now）。
model_instance是此字段所属的实例，add是实例是否第一次保存到数据库。
它应该返回此字段的model_instance适当属性的值。属性名称位于self.attname（这是由Field设置）。
有关使用情况，请参阅保存前预处理值。
当在字段上使用查找时，该值可能需要“准备”。Django公开了两种方法：
在用于查找之前，准备values到数据库。The lookup_type will be one of the valid Django filter lookups: "exact", "iexact", "contains", "icontains", "gt", "gte", "lt", "lte", "in", "startswith", "istartswith", "endswith", "iendswith", "range", "year", "month", "day", "isnull", "search", "regex", and "iregex".
如果你使用自定义查找，则lookup_type可以是在字段中注册的任何lookup_name。
有关用法，请参见准备在数据库查找中使用的值。
类似于get_db_prep_value()，但用于执行查找。
与get_db_prep_value()一样，将用于查询的特定连接作为connection传递。此外，prepared描述该值是否已经用get_prep_lookup()准备好。
字段经常从不同的类型接收它们的值，从序列化或从表单。
改变这个值为正确的python对象。它作为value_to_string()的反向操作，也在clean()中调用。
有关用法，请参见将值转换为Python对象。
除了保存到数据库，该字段还需要知道如何序列化其值：
将obj转换为字符串。用于序列化字段的值。
有关用法，请参见转换字段数据以进行序列化。
当使用模型 表单时，Field需要知道应由哪个表单字段表示：
返回ModelForm的此字段的默认django.forms.Field。
默认情况下，如果form_class和choices_form_class都是None，则使用CharField；如果给出choices_form_class，则返回TypedChoiceField。
有关用法，请参见为模型字段指定表单字段。
每个字段实例包含几个允许内省其行为的属性。使用这些属性而不是isinstance检查何时需要编写取决于字段功能的代码。这些属性可与Model._meta API一起使用，以缩小特定字段类型的搜索范围。自定义模型字段应实现这些标志。
布尔标志，指示是否自动创建字段，例如模型继承使用的OneToOneField。
布尔标志，指示字段是否具有与其相关联的数据库列。
布尔标志，指示是否使用字段来回复另一个非隐藏字段的功能（例如，构成GenericForeignKey的content_type和object_id ）。hidden标志用于区分模型上的公共字段子集构成模型上的所有字段。
注意
Options.get_fields()默认排除隐藏字段。传入include_hidden = True可返回结果中的隐藏字段。
布尔标志，指示字段是否包含对一个或多个其他模型的功能的引用（例如ForeignKey，ManyToManyField，OneToOneField等） 。
返回定义字段的模型。如果在模型的超类上定义了字段，则模型将引用超类，而不是实例的类。
这些属性用于查询关系的基数和其他详细信息。这些属性存在于所有字段上；但是，如果字段是关系类型（Field.is_relation=True），则它们只有布尔值（而不是None）。
如果字段具有多对多关系，则布尔标志为True；否则为False。Django中包含的仅有True的字段为ManyToManyField。
如果字段具有多对一关系，例如ForeignKey，则布尔标志为True；否则为False。
如果字段具有一对多关系（例如GenericRelation或ForeignKey的反向），则True的布尔标志；否则为False。
如果字段具有一对一关系，例如OneToOneField，则布尔标志为True；否则为False。
指向字段涉及的模型。例如，ForeignKey(Author)中的Author。如果字段具有通用关系（例如GenericForeignKey或GenericRelation），则related_model将为None。
2015年5月13日