Field 元素（列表）

项目
06/15/2015

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

定义在 SharePoint 网站的列表基础结构中使用的内部数据类型。字段是用户可以向列表添加的信息列或属性。

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"  LinkToItemAllowed = "Text"
  List = "Text"  ListItemMenu = "TRUE" | "FALSE"  ListItemMenuAllowed = "Text
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number" 
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text" 
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"  Version = "Text"
  Viewable = "TRUE" | "FALSE"  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

属性

属性	说明
Aggregation	可选属性，类型为 Text。在 XML 表单上的聚合字段中使用，以指定应用于由 XPath 表达式返回的值或元素集合的函数。如果使用 Node 属性指定返回值集合的 XPath 表达式，则还可以包含一个 Aggregation 属性，该属性指定要对返回的值集合执行的操作。此操作可以是一个聚合函数，也可以是集合中特定元素的指示。可能的值包括： sum 添加值。 count 计算值的数量。 average 查找值的平均值。 min 查找最小值。 max 查找最大值。 merge 合并值。 plaintext 将节点文本内容转换为纯文本。 first 对集合中的第一个元素应用属性升级和降级。 last 对集合中的最后一个元素应用属性升级和降级。有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、PrimaryPIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
AllowDeletion	可选属性，类型为 Boolean。如果可以删除字段，则为 TRUE。
AllowHyperlink	可选属性，类型为 Boolean。如果可以在字段中使用超链接，则为 TRUE。
AllowMultiVote	可选属性，类型为 Boolean。如果在调查中允许有多个响应，则为 TRUE。
AppendOnly	可选属性，类型为 Boolean。在列表中启用版本控制时，如果文本只能附加到 Note 字段中的现有文本，则为 TRUE。
AuthoringInfo	可选属性，类型为 Text。在字段编辑页中显示的描述性字符串，用于标识字段及其用途；例如，LinkTitle 字段具有创作信息"（链接到项目）"。如果存在用于其他用途的同名字段，则通常会使用此属性。
BaseType	可选属性。BaseType 属性可设置为 Integer，这会将值存储为整数；也可设置为 Text（默认值），这会将值存储为文本。不能创建整数基类型选项字段。
CalType	可选属性，类型为 Integer。指定日历类型。可能的值包括： 16 萨卡时代日历 15 中国农历 14 朝鲜和日本农历 12 公历 - 法语转译 11 公历 - 英语转译 10 公历 - 阿拉伯语 9 公历 - 法语(中东) 8 希伯来农历 7 泰语 6 回历(阿拉伯语农历) 5 朝鲜日历(檀纪) 4 中国台湾日历 3 日本和历 1 公历 0 未指定类型
CanToggleHidden	可选属性，类型为 Boolean。如果可以通过用户界面隐藏字段，则为 TRUE。
ClassInfo	可选属性，类型为 Text。指定用于标准表视图中的字段的级联样式表 (CSS) 类。如果进行了设置，则将会使用指定的类，而不使用标准的 ms-vb2 类。
ColName	可选属性，类型为 Text。一个内部属性，定义字段与此字段的物理存储名称之间的映射。这必须是基础数据库中的有效名称，并且必须与数据库表中使用的名称相同。如果未指定，则服务器将生成一个列名称，此列名称不会与任何现有列名称发生冲突并只包含 Microsoft SQL Server 允许的字符。
ColName2	可选属性，类型为 Text。
Commas	可选属性，类型为 Boolean。如果使用逗号来分隔千位，则为 TRUE。
Customization	可选属性，类型为 Text。
Decimals	可选属性，类型为 Integer。确定要显示的小数位数。将根据显示精度对显示的值进行四舍五入；例如，若四舍五入到一位小数，则 1.05 将显示为 1.1。
Description	可选属性，类型为 Text。提供列表的编辑表单中显示的说明（如果已指定字段说明）。默认情况下，Microsoft SharePoint Foundation 中的字段没有说明。
Dir	可选属性，类型为 Text。指定支持双向阅读顺序的字段的文本方向。可能的值为 LTR（从左到右）、RTL（从右到左）和 none。
Direction	可选属性，类型为 Text。
DisplaceOnUpgrade	可选属性，类型为 Boolean。如果字段已存在字段定义，则为 TRUE，以强制使用字段定义中指定的值更新字段属性。
DisplayImage	可选属性，类型为 Text。指定为列显示的图标的名称。
DisplayName	可选属性，类型为 Text。字段的显示名称。对于文字大小或空格的使用，不存在任何限制。显示名称可以由用户编辑，并可以在初次创建字段后发生更改。当字段在表视图中显示时，此名称将用作列标题；当字段在表单中显示时，此名称将用作表单标签。如果给定一个显示名称，则 < FieldName / > 标记返回该显示名称；否则，它将默认返回 Name 属性中的名称。
DisplayNameSrcField	可选属性，类型为 Text。通常用于需要与另一个字段具有相同名称的计算字段。如果用户已修改源字段并更改显示名称，则此字段的显示名称也将发生更改。该字符串引用其他字段的名称。
DisplaySize	可选属性，类型为 Integer。
Div	可选属性，类型为 Number。在显示数目之前，除法中使用的比例因子。显示数目为 N * Mult / Div（四舍五入到 Decimals 指定的数目）。
EnableLookup	可选属性，类型为 Boolean。若要启用字段中的查找值，则为 TRUE。
EnforceUniqueValues	可选属性，类型为 Boolean。
ExceptionImage	可选属性，类型为 Text。在 Recurrence 字段类型中使用，以指定要用于例外情况的图像文件的名称。
FieldRef	可选属性，类型为 Text。指定字段所引用的另一个字段（例如，查阅字段）的名称。
FillInChoice	可选属性，类型为 Boolean。如果字段允许用户填写列值，则为 TRUE。
Filterable	可选属性，类型为 Boolean。如果可以对字段进行筛选，则为 TRUE。
FilterableNoRecurrence	可选属性，类型为 Boolean。如果可以对未扩展定期事件的视图中的字段创建筛选器，则为 TRUE。如果 Filterable 包含 TRUE，则可以在所有视图中对字段进行筛选，而与如何设置 FilterableNoRecurrence 无关。
ForcedDisplay	可选属性，类型为 Text。指定要显示的文本，此文本将代替实际字段值。在调查中使用此属性可阻止显示用户名。
ForcePromoteDemote	可选属性，类型为 Boolean。
Format	可选属性，类型为 Text。指定用于数值的格式。对于日期/时间字段，可能是下面的值： DateOnly 仅显示（并允许编辑）日期部分（对于所有编辑的值，时间部分均设置为 12:00 A.M.）。 DateTime 显示和编辑日期和时间（默认值）。 ISO8601 按照转换为协调世界时 (UTC) 格式的 ISO8601 时间格式 (YYYY-MM-DDTHH:MM:SSZ) 显示日期和时间。此格式是用于 2007 Microsoft Office system 中的文档属性的格式，同时也是 SharePoint Foundation 中用于 New 及 Edit 表单和服务器之间的标准交换格式。 ISO8601Basic 使用 8601 日期/时间格式的缩写形式 (YYYYMMDDTHHMMSSZ)。此格式用于 vCard/iCal。对于 Choice 字段，此属性可设置为 Dropdown（默认值），这将通过下拉选项提供编辑选项；也可以设置为 RadioButtons，这将通过一组单选按钮提供选项。对于 URL 字段，此属性可设置为 Hyperlink（默认值），这会将 URL 显示为常规的 <A> 标记；也可以设置为 Image，这会将 URL 显示为 <IMG SRC="URL" ALT="Description">。
FromBaseType	可选属性，类型为 Boolean。不建议使用此属性，而应使用 Sealed 属性。
Group	可选属性，类型为 Text。指定字段所属的列组。
HeaderImage	可选属性，类型为 Text。指定要用作字段中的标题的图像文件的名称。
Height	可选属性，类型为 Integer。指定为用户信息列表中的用户显示的图像的高度（以像素为单位）。
Hidden	可选属性，类型为 Boolean。若为 TRUE，则会在用户界面上完全隐藏字段。若将 ReadOnly 设置为 TRUE，则表示字段在新建表单或编辑表单中不显示，但仍可以包含在视图中。
HTMLEncode	可选属性，类型为 Boolean。如果为 TRUE，则转换嵌入的字符，以便这些字符作为文本显示在浏览器中；将可能与 HTML 标记相混淆的字符转换为实体
ID	可选属性，类型为 Text。指定括号 ({}) 中包含的字段的 GUID。
Id	可选属性，类型为 Text。
IMEMode	可选属性，类型为 Text。指定用于字段的输入法编辑器 (IME) 模式偏量。当一个编写系统具有的字符多于可为给定键盘编码的字符时，IME 允许语言之间的键击转换。可能的值包括： auto 未使用。若要指定此 IME 模式，请将 IMEMode 属性值设置为空字符串 ("")。 active 通过 IME 键入所有字符，但用户仍可以停用 IME。 inactive 在不使用 IME 的情况下键入字符，但用户仍可以激活 IME。
Indexed	可选属性，类型为 Boolean。如果编制列索引以用于视图筛选器，则为 TRUE。
IsolateStyles	可选属性，类型为 Boolean。对于其 RichText 属性为 TRUE 且 RichTextMode 属性为 FullHtml 的 Text 字段，此属性指定服务器将重写此字段的 HTML 以确保它不会干扰周围页面的呈现。
IsRelationship	可选属性，类型为 Boolean。如果可从列表中（该字段在其中查找其值）检测到该字段，则为 TRUE。
JoinColName	可选属性，类型为 Text。仅为查阅字段定义此属性。除了指示在本地和外部列表之间的 SQLJOIN 中使用的列的名称之外，此属性与 ColName 非常类似。通常不应自定义此值。当前仅在某些内置和基类型字段的字段架构中使用此值，以指示在与 UrlID 列联接的 URL (DocMd) 表中进行查找。
JoinRowOrdinal	可选属性，类型为 Integer。不应从代码中直接使用。
JoinType	可选属性，类型为 Text。指定字段上使用的 JOIN 类型。可能的值包括 INNER、LEFTOUTER 和 RIGHTOUTER。
LCID	可选属性，类型为 Integer。LCID 属性可用于指定采用所使用的货币格式的国家/地区（例如，1033 代表美国）。在两种特殊情况下将使用欧元符号格式。如果 LCID = -1 (0xFFFFFFF)，则会将欧元符号作为前缀添加到数字中；如果 LCID = -2 (0xFFFFFFE)，则会将欧元符号作为后缀添加到数字中。小数位数为 2，但字段的 Decimals 属性可以重写此数目。欧元货币符号在 UCS-2 中等于 0x20AC。
LinkToItem	可选属性，类型为 Boolean。
LinkToItemAllowed	可选属性，类型为 Text。
List	可选属性，类型为 Text。指定列表的内部名称。
ListItemMenu	可选属性，类型为 Boolean。
ListItemMenuAllowed	可选属性，类型为 Text。
Max	可选属性，类型为 Number。指定字段允许的最大值。
MaxLength	可选属性，类型为 Integer。指定字段值中允许的字符的最大数目。调整编辑表单以强制使用此值（将在客户端上验证此值）。如果用户尝试输入的字符的数目多于 MaxLength 设置的字符的数目，将出现一条错误消息。
Min	可选属性，类型为 Number。指定字段允许的最小值。
Mult	可选属性，类型为 Boolean。在显示数字之前，在乘法中使用的比例因子。
Name	必需属性，类型为 Text。字段的名称。这是字段的内部名称，并且保证在字段定义的生存期内绝不会更改。相对于列表中的字段集，它必须是唯一的。该名称基于用户定义的字段名称自动生成。
NegativeFormat	可选属性，类型为 Text。指定如何指示负值。可以设置为下列值之一： MinusSign 使用减号作为前缀。 Parens 用括号括起来。
Node	可选属性，类型为 Text。在 XML 表单中使用，除了处理指令 (PI) 链接之外，此属性是所有字段必需的，它为提升的节点指定 XPath 表达式。
NoEditFormBreak	可选属性，类型为 Boolean。若为 TRUE，则阻止在新项目表单或编辑项目表单中的字段之间添加换行符。某些字段类型（如格式文本字段）默认情况下会提供间距，此属性可用来控制由此产生的额外间距。
NumLines	可选属性，类型为 Integer。建议编辑过程中在 TEXTAREA 块中显示的行数。这只是客户端用户界面提示，对于可以编辑的文本行数量没有任何强制性限制。
Percentage	可选属性，类型为 Boolean。如果值显示为百分比，则为 TRUE；即，将数字乘以 100%。
PIAttribute	可选属性，类型为 Text。指定文档处理指令（由 PITarget 属性指定）中要用作列值的属性。用于在 XML 文档中进行属性升级和降级。如果指定 PIAttribute 属性，则还必须指定 PITarget 属性。有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PITarget	可选属性，类型为 Text。指定文档处理指令，其中列值存储在此内容类型的文档中。用于在 XML 文档中进行属性升级和降级。如果指定 PIAttribute 属性，则还必须指定 PITarget 属性。有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PrependId	可选属性，类型为 Boolean。用于问题跟踪列表中，若要显示编辑和新建项目表单中相关问题项目的集合 ID，则为 TRUE。
Presence	可选属性，类型为 Boolean。如果字段中显示用户信息，则为 TRUE。
PrimaryKey	可选属性，类型为 Boolean。如果字段为一个列表和另一个列表之间的关系中的主键，则为 TRUE。
PrimaryPIAttribute	可选属性，类型为 Text。用于在 XML 文档中进行属性升级和降级。指定文档处理指令（由 PrimaryPITarget 指定）中要用作列值的替换属性。如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。如果指定，则 SharePoint Foundation 会在 PITarget 和 PIAttribute 属性中指定的值之前使用这些值。有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PrimaryPITarget	可选属性，类型为 Text。指定备用文档处理指令，其中将为此内容类型的文档存储列值。如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。如果指定，则 SharePoint Foundation 会在 PITarget 和 PIAttribute 属性中指定的值之前使用这些值。有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
ReadOnly	可选属性，类型为 Boolean。如果为 TRUE，则字段不会在新建表单或编辑表单中显示，但可以包含在视图中。此外，将 ReadOnly 设置为 TRUE，可以在用于管理网站栏和内容类型的网站设置页上隐藏字段。若将 Hidden 属性设置为 TRUE，则会在用户界面上完全隐藏字段。如果不包括此属性，则 SharePoint Foundation 会按照此属性设置为 False 的情况处理列。
ReadOnlyEnforced	可选属性，类型为 Boolean。若要指定用户无法通过任何方式更改字段，只有系统才能更改此字段，则为 TRUE。
RelationshipDeleteBehavior	可选属性，类型为 Text。指定字段的删除行为。可能的值包括 Cascade、Restrict 和 None。
RenderXMLUsingPattern	可选属性，类型为 Boolean。用于计算字段以确定显示格式。如果为 TRUE，则将基于计算字段的显示模式而不是基于计算字段所基于的第一个非计算字段引用的列值来呈现值。例如，在图片库中，图片大小列是由宽度 x 高度来表示的，但如果该属性未设置为 TRUE，则仅显示第一个字段引用（宽度）。如果设置为 TRUE，则显示格式宽度 x 高度。
Required	可选属性，类型为 Boolean。如果为 TRUE，则不得对字段分配空值。如果在表单发布中未给定非空字段值，则会在错误表单中显示标准的必需字段文本或显式指定的消息（即，通过 <ErrorText> 标记）。此验证仅由客户端处理（数据库始终允许所有用户自定义的字段为 NULL）。
RestrictedMode	可选属性，类型为 Boolean。如果为 TRUE，则不允许 Note 字段包含增强的格式文本格式（例如图片、表或超链接），也不允许将格式化文本粘贴到此字段。
ResultType	可选属性，类型为 Text。指定从字段返回的值的数据类型。
RichText	可选属性，类型为 Boolean。如果字段显示格式文本格式，则为 TRUE。
RowOrdinal	可选属性，类型为 Integer。指定字段的数据库位置。
Sealed	可选属性，类型为 Boolean。若为某个列表的 Schema.xml 文件中的某个字段将此属性设置为 TRUE，则会在"更改列"页中将该字段标记为不可移除。
SeparateLine	可选属性，类型为 Boolean。在内部使用以支持在单独的行中呈现字段（例如，备注或注释）。此属性不是公共属性。
SetAs	不应从代码中直接使用。
ShowAddressBookButton	不应从代码中直接使用。
ShowAlways	可选属性，类型为 Boolean。
ShowField	可选属性。ShowField 属性可设置为要显示的字段名称。默认情况下，将显示来自外部列表中的记录的"标题"字段的超链接文本。但是可使用 ShowField 属性重写该值，并显示外部列表中的另一个字段。允许将以下数据类型用作 ShowField 属性的目标：Text、Choice 和 Counter。对于 Lookup 字段，必须将此参数设置为内部字段名称；将其设置为显示名称不会引发错误，但会破坏此字段。
ShowInDisplayForm	可选属性，类型为 Boolean。若要在表单中显示字段以查看项目，则为 TRUE。
ShowInEditForm	可选属性，类型为 Boolean。若要在表单中显示字段以编辑项目，则为 TRUE。
ShowInFileDlg	可选属性，类型为 Boolean。此属性仅对于文档库架构中的字段有效。如果为 FALSE，则字段不会在用于保存表单的属性对话框（从客户端应用程序保存表单时出现）中显示。例如，由于此属性是直接在要保存到文档库的文档中设置的，因此 Title 字段具有此属性。
ShowInListSettings	可选属性，类型为 Boolean。若要页上显示列以用于自定义列表设置，则为 TRUE。
ShowInNewForm	可选属性，类型为 Boolean。如果为 FALSE，则当显示模式设置为 New 时，字段不会出现在 Fields 枚举中。具有此设置的字段不会出现在给定列表的默认"新建项目"页中。具体而言，可以在用于将文档上载到文档库的页上隐藏字段。
ShowInVersionHistory	可选属性，类型为 Boolean。若要在页上显示列以查看列表项版本，则为 TRUE。
ShowInViewForms	可选属性，类型为 Boolean。选择 TRUE 可指定字段显示在用于查看列表数据的页面中。
Sortable	可选属性，类型为 Boolean。如果可以对字段中的值进行排序，则为 TRUE。
SourceID	可选属性，类型为 Text。包含定义字段的命名空间（如 https://schemas.microsoft.com/sharepoint/v3），或者在其中创建自定义字段的列表的 GUID。
StaticName	可选属性，类型为 Text。包含字段的内部名称。
StorageTZ	指定如何存储日期/时间值。当 StorageTZ 设置为 UTC 时，将日期/时间作为协调世界时 (UTC) 处理。若要指示一个引用"抽象"时间的日期/时间值，也就是说在用户输入日期/时间时将其存储到数据库中，而不进行本地时区转换或存储，请忽略 StorageTZ 属性。
StripWS	可选属性，类型为 Boolean。如果从字段值的开头和结尾移除空白，则为 TRUE。
SuppressNameDisplay	可选属性，类型为 Boolean。若要在 User 字段中不显示用户名，则为 TRUE。
TextOnly	可选属性，类型为 Boolean。如果为 TRUE，则字段仅可以包含 Text 值。
Title	可选属性，类型为 Text。包含用户界面中显示的字段的标题。
Type	必需属性，类型为 Text。字段的数据类型（除非 Field 元素是 ProjectedFields 的子集）。备注在 Microsoft SharePoint Foundation 2010 的技术预览版中，Type 属性具有不同的含义，并且当它是 ProjectedFields 的子集时，只有一个可能的值（"Lookup"）。有关 Type 的这一用法的详细信息，请参阅 ProjectedFields 元素（视图）。默认情况下，SharePoint Foundation 包括以下数据类型： AllDayEvent 指定全天事件。对应于 bit SQL 数据类型。 Attachments 存储附件的 URL。对应于 bit SQL 数据类型。 Boolean 用于存储 TRUE/FALSE 值（在数据库中存储为 0 或 1）。可对此字段进行排序和分组。对应于 bit SQL 数据类型并由 SPFieldBoolean 类表示。 Calculated 指定基于其他列来计算其值的字段。对应于 sql_variant SQL 数据类型并由 SPFieldCalculated 类表示。 Choice 允许用户指定预先确定的一组值，可使用这些值在字段中输入数据。Choice 和 Lookup 类型是用于排序和分组的最重要的字段。BaseType 和 Format 属性可用于选择字段。可对此字段进行排序和分组。当为选择选项指定某个值时，该值将用作字段选择的提交值。如果不指定值，该选项将作为选项的文本值提交。在所有情况下，选项的文本值都是用户界面（下拉列表或单选按钮文本）中显示的内容。选项在编辑用户界面中显示的顺序始终是在 CHOICES 元素中指定项目的顺序。使用 MultiChoice 类型可指定 Choice 字段，此字段可实现复选框并允许用户选择多个值。对应于 nvarchar SQL 数据类型并由 SPFieldChoice 类表示。 Computed 指定一个字段，该字段的内容取决于另一个字段。例如，LinkTitleNoMenu 等同于在"标题"字段值周围使用一个超链接。由 SPFieldComputed 类表示。 ContentTypeId 包含一个内容类型 ID。有关内容类型 ID 的格式的信息，请参阅内容类型 ID。对应于 varbinary SQL 数据类型。 Counter 通常仅用于内部 ID 字段。其整数值将自动设置为相对于当前列表中每个其他项是唯一的。Counter 类型始终为只读并且不能通过表单发布设置。可以对此字段进行排序，但不能对其进行分组。对应于 int SQL 数据类型。 CrossProjectLink 用于将 SharePoint 列表中的事件与会议工作区网站连接起来；专门指新建项目和编辑项目表单中用于创建项目的会议工作区网站的复选框的字段类型。对应于 bit SQL 数据类型并由 SPFieldCrossProjectLink 类表示。 Currency 允许输入货币值。每个货币字段都绑定到特定区域设置的货币。在所有其他方面，都将其视为 Number 字段类型。使用 LCID 属性可指示特定区域设置的货币。Decimals、Max 和 Min 属性可用于货币类型。可对此字段进行排序和分组。对应于 float SQL 数据类型并由 SPFieldCurrency 类表示。 DateTime 允许存储完全限定的日期或时间。可使用 Format 属性指定日期格式，并使用 StorageTZ 属性确定如何存储日期/时间值。可对此字段进行排序和分组。对于"显示"模式，日期格式的顺序将派生自区域设置（"M/D/Y"或"D/M/Y"）。在"编辑"模式（或 Default 元素值的"新建"模式）中，将以通用格式 (M/D/Y hh:mm am/pm) 呈现日期/时间。对应于 datetime SQL 数据类型并由 SPFieldDateTime 类表示。 File 包含一个文件。对应于 uniqueidentifier SQL 数据类型。 GridChoice 包含调查的评估范围。对应于 ntext SQL 数据类型并由 SPFieldRatingScale 类表示。 Guid 允许全局唯一标识符 (GUID)。对应于 uniqueidentifier SQL 数据类型。 Integer 允许正整数或负整数值。Commas 和 NegativeFormat 属性用于指定整数格式。对应于 int SQL 数据类型。 Lookup 行为与 Choice 字段非常类似，但可用选项来自另一个列表而不是硬编码的值选项。List 和 ShowField 属性可用于查阅字段。可对此字段进行排序和分组。若要进行排序和分组，请使用 DisplayField 值（默认情况下为 Title），而不是列表中存储的外键。对应于 int SQL 数据类型并由 SPFieldLookup 类表示。 LookupMulti 可包含多个值的 Lookup 字段。父类型：Lookup。 ModStat 包含内容批准状态。可能的值包括 Approved（默认值）、Rejected 和 Pending（在数据库中分别存储为 0、1 或 2）。对应于 int SQL 数据类型。 MultiChoice 指定实现复选框并允许用户选择多个值的 Choice 字段。对应于 ntext SQL 数据类型并由 SPFieldMultiChoice 类表示。 MultiColumn 一个 Note 字段，它模拟包含多个值的字段。有关多列字段类型的示例，请参阅如何：创建自定义字段类型定义。有关多列字段的信息，请参阅自定义多列字段类。父类型：Note。 Note 允许用户输入多行文本。不可对此字段进行排序或分组。所有文本都定义为不带 HTML 标记的纯 ASCII 字符。任何看起来像 HTML 标记或 URL 的内容（如 Server.HTMLEncode）都会简单地用引号引起来，以使其看起来像纯文本。用于编辑此格式的控件是一个简单的 TEXTAREA 块。使用 NumLines 属性指定要显示的行数。对应于 ntext SQL 数据类型并由 SPFieldMultiLineText 类表示。 Number 允许输入浮点数。可对此字段进行排序和分组。根据当前区域设置来分析输入数字的小数点和千位分隔符。可以通过用括号将数字括起来或使用负号来指示负数。下面的属性可以与 Number 属性一起使用来指定数字格式：Decimals、Div、Max、Min、Mult 和 Percentage。对应于 float SQL 数据类型并由 SPFieldNumber 类表示。 PageSeparator 在调查列表中插入分页符。由 SPFieldPageSeparator 类表示。 Recurrence 用于为事件列表中的项编辑和定义定期模式。对应于 bit SQL 数据类型。 Text 在编辑框中输入的单行文本。可对此字段进行排序和分组。使用 MaxLength 属性可设置允许的最大字符数。对应于 nvarchar SQL 数据类型并由 SPFieldText 类表示。 ThreadIndex 包含指示对话线索中消息的相对位置的 ID。对应于 varbinary SQL 数据类型。 Threading Threading 字段类型可在创建和显示类似于以线索组织的讨论的视图时使用。任何列表都可以包含线索列，但是当使用此列时，会生成一个特殊的用户界面。（它绝不会显示为表单中标准的可编辑字段，也不会显示为视图中的普通列。）如果对线索字段进行排序，将以父子关系中返回所有记录的预排序遍历。通过将特定记录的所有父记录的创建日期和 ID 号以串联的方式进行保存可做到这一点。对应于 varchar SQL 数据类型。 URL 用于创建任意形式的超链接。URL 字段显示为 <A HREF="URL">说明</A>。如果未提供任何说明，则它将显示为 <A HREF="URL">URL</A>。URL 文本本身存储在 URL (DocMd) 表中，该表存储了服务器上 SharePoint 数据库中的所有 URL。这样做是为了在 URL 的目标位置改变时，可通过链接修复来更新服务器上的任何本地 URL。当删除包含 URL 字段的记录时，也会从 URL 表中删除相应的引用记录。可对此字段进行排序和分组。（根据文本说明而不是 URL 的内容进行排序；如果未提供任何说明，则按空白进行排序。）当 Type 为 URL 时，可以使用 LinkType 属性指定链接的类型。对应于 nvarchar SQL 数据类型并由 SPFieldUrl 类表示。 User 引用 UserInfo 数据库表的 Lookup 字段。对应于 int SQL 数据类型并由 SPFieldUser 类表示。 UserMulti 可包含多个值的 User 字段。父类型：LookupMulti。 WorkflowEventType 指定由 SPWorkflowHistoryEventType 枚举表示的工作流事件类型。父类型：Integer。 WorkflowStatus 指定由 SPWorkflowStatus 枚举表示的工作流状态。对应于 nvarchar SQL 数据类型。
UniqueId	可选属性，类型为 Text。不应从代码中直接使用。
UnlimitedLengthInDocumentLibrary	可选属性，类型为 Boolean。若要允许文档库中的字段长度不受限制，则为 TRUE。
URLEncode	可选属性，类型为 Boolean。若要将特殊字符（如空格）转换为引用的 UTF-8 格式（例如，表示字符 ë 的 %c3%ab），则为 TRUE。
URLEncodeAsURL	可选属性，类型为 Boolean。虽然类似于 URLEncode，但若要指定要编码的字符串是 URL 的路径组件以便不对左斜线（"/"）进行编码，则为 TRUE。
UserSelectionMode	可选属性，类型为 Text。指定是只能在项目表单上的用户字段中选择单个用户的名称，还是可以同时选择个人和组的名称。可能的值包括： 0 - 只能选择个人名称。 1 - 可以同时选择个人和组的名称。
UserSelectionScope	可选属性，类型为 Integer。指定一个范围，以便在项目表单上的用户字段中选择用户名。如果值为 0，则对 SharePoint 组没有限制。如果值大于 0，则用户选择仅限于其 ID 等于指定值的 SharePoint 组的成员。
Version	可选属性，类型为 Text。
Viewable	可选属性，类型为 Boolean。若要指定将字段添加到默认视图中，则为 TRUE。默认值为 TRUE。
WebId	可选属性，类型为 Text。
Width	可选属性，类型为 Integer。指定为用户信息列表中的用户显示的图像的宽度（以像素为单位）。
WikiLinking	可选属性，类型为 Boolean。若要指定将以双层括号 ([[…]]) 形式显示的 Wiki 链接转换为使用 <a> 标记的 HTML 链接，则为 TRUE。
XName	可选属性，类型为 Text。在 XML 表单内部使用以标识已添加、删除或修改的字段。此属性不是公共属性。

子元素

CHOICES、Customization、Default、DefaultFormula、DisplayBidiPattern、DisplayPattern、FieldRefs、Formula、FormulaDisplayNames、MAPPINGS、Validation

父元素

Fields、ProjectedFields

出现次数

最小值：0

最大值：无限次（当父级为 Fields 时）。当父级为 ProjectedFields 时，最大值是正在查询的主列表中允许字段的最大数目与列表中已存在的字段数的差。

备注

若要为基于默认的 SharePoint Foundation 字段类型的列表定义创建自定义字段定义，请在 Schema.xml 文件中使用 Field (List - Definition) 元素。若要将自定义字段定义创建为可插入功能，该功能基于默认的字段类型并且可在网站集内的网站和列表中重复使用，请使用 Field（字段）元素来定义自定义网站栏。若要创建为特定数据有效性和字段呈现实现自定义类的自定义字段类型，请使用 Field（字段类型）元素。

可以从视图定义引用字段，也可以从计算字段呈现元素中的表达式引用字段。使用 Field（视图）元素可为视图中显示的内容返回已设置格式的字段值，使用 Column（视图）元素可返回该字段的原始数据值。用于引用字段的语法如下所示：

<Field Name="FieldName"/>

默认情况下，使用上表中指定的字段定义的默认属性来呈现字段。可以在 FieldRef 属性的 CAML 标记中重写任何字段属性，这将重写为字段自身给定的定义。（不能更改字段的 Type 属性。）

<Property Select="DisplayName"/> 可用于显示字段的用户定义的显示名称。

在 Fields 元素枚举中，Name 属性可以省略。对于某些字段引用，可使用 <Column/> 访问为字段存储的原始数据。

通过 Property 元素可呈现来自表单和创作用户界面的某些方面的字段的一些属性（例如，<Property Select="Description"/> or <Property Select="Type"/>）。这些元素仅按照名称检索任何字段属性或子元素 (Property) 的值。

除上述类型之外，下面的预定义的字段也可用于 Field 元素。

名称	说明
Created	包含 DateTime 值的字段，该值指定项目的创建时间（按照 UTC 格式）。
CreatedBy	包含 Lookup 值的字段，该值引用 UserInfo 表并指示创建项目的用户。
Edit	包含指向用于编辑项目的表单的超链接的计算字段（没有其他架构）。此字段引用用于编辑项目和标识它的 ID 字段的页。
ID	与每个列表中的每一项相关联的 Counter 字段类型。在编辑时，ID 唯一标识 URL 和 POST 表单中的列表项。若在 Cmd=Save 命令中将 New 指定为 ID 属性的值，则会创建一个项目，而不是编辑当前项目。
Modified	包含 DateTime 值的字段，该值指定上次修改项目的时间（按照 UTC 格式）。Modified 时间也用作某种 Version 字段。总是在编辑现有项目时发布项目的上次修改日期。如果该日期与当前的修改日期不匹配，则服务器将无法编辑并为用户返回一个错误，并提供指向服务器上的当前数据的链接（将在新的窗口中打开），以便能够将发布的值从旧的表单复制到新的表单。
ModifiedBy	包含针对 UserInfo 表的 Lookup 值的字段，该值指示上次修改项目的用户。
Title	每个项目的一般显示名称。每个项目在不同的列表中可能具有不同的显示名称，但具有相同的内部字段名称 Title。标题是为要列出的 Lookup 字段显示的默认文本。
LinkTitle	显示指向项目的超链接的计算字段，其中包含标题文本并生成指向项目的 URL（和新的图标引用）。此字段没有任何额外的存储区；它依靠 ID 字段和 Title 字段来呈现其用户界面。

备注

Fields 枚举中返回的字段受显示模式的影响。绝不返回用 Hidden 属性标记的字段。如果正在呈现某个表单（如果从 ListForm 元素中调用 Fields），则不返回用 ReadOnly 属性标记的字段。在"新建"或"预览"显示模式中，不返回用 ShowInNewForm 属性标记的字段。当呈现 NewForm 对话框表单时，不返回用 ShowInFileDlg 属性标记的字段。

示例

下面的示例使用 Field 元素来指定名为 Area 的列表的选项。

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>