Field 元素 (List)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

定义 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>

元素和属性

以下部分介绍属性、子元素和父元素：

Attributes

属性 说明
聚集
可选属性，类型为 Text。 在 XML 表单上的聚合字段中使用，以指定应用于由 XPath 表达式返回的值或元素集合的函数。 如果使用 Node 属性指定返回值集合的 XPath 表达式，则还可以包含一个 Aggregation 属性，该属性指定要对返回的值集合执行的操作。 此操作可以是一个聚合函数，也可以指定集合中的特定元素。

可能的值包括：
- 和 添加值。
- 计数 计算值的数目。
- 平均 查找值的平均值。
- min 查找最小值。
- 麦克斯 查找最大值。
- 合并 合并值。
- 明文 将节点文本内容转换为纯文本。
- 第一 将属性提升和降级应用于集合中的第一个元素。
- 最后 将属性提升和降级应用于集合中的最后一个元素。

有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、PrimaryPIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅Using Content Types to Specify XML Document Properties。
AllowDeletion
可选属性，类型为 Boolean。 如果可以删除字段，则为 TRUE。
AllowHyperlink
可选属性，类型为 Boolean。 如果可以在字段中使用超链接，则为 TRUE。
AllowMultiVote
可选属性，类型为 Boolean。 如果在调查中允许有多个响应，则为 TRUE。
AppendOnly
可选属性，类型为 Boolean。 在列表中启用版本控制时，如果文本只能附加到 Note 字段中的现有文本，则为 TRUE。
AuthoringInfo
可选 文本。 在字段编辑页中显示的描述性字符串，用于标识字段及其用途；例如，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
可选 文本。
逗号
可选属性，类型为 Boolean。 如果使用逗号来分隔千位，则为 TRUE。
自定义选项
可选 文本。
小数
可选属性，类型为 Integer。 确定要显示的小数位数。 将根据显示精度对显示的值进行四舍五入；例如，若四舍五入到一位小数，则 1.05 将显示为 1.1。
说明
可选属性，类型为 Text。 提供列表的编辑表单中显示的说明（如果已指定字段说明）。 默认情况下，Microsoft SharePoint Foundation 中的字段没有说明。
Dir
可选属性，类型为 Text。 指定支持双向阅读顺序的字段的文本方向。 可能的值为 LTR（从左到右）、RTL（从右到左）和 none。
方向
可选 文本。
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
可选 文本。 在 Recurrence 字段类型中使用，以指定要用于例外情况的图像文件的名称。
FieldRef
可选属性，类型为 Text。 指定字段所引用的另一个字段（例如，查阅字段）的名称。
FillInChoice
可选属性，类型为 Boolean。 如果字段允许用户填写列值，则为 TRUE。
Filterable
可选属性，类型为 Boolean。 如果可以对字段进行筛选，则为 TRUE。
FilterableNoRecurrence
可选属性，类型为 Boolean。 如果可以对未扩展定期事件的视图中的字段创建筛选器，则为 TRUE。 如果 Filterable 包含 TRUE，则可以在所有视图中对字段进行筛选，而与如何设置 FilterableNoRecurrence 无关。
ForcedDisplay
可选属性，类型为 Text。 指定要显示的文本，此文本将代替实际字段值。 在调查中使用此属性可阻止显示用户名。
ForcePromoteDemote
可选属性，类型为 Boolean。
Format
可选属性，类型为 Text。 指定用于数值的格式。

对于日期/时间字段，可能是下面的值：
- DateOnly 显示 (并允许编辑以仅) 日期部分， (时间部分设置为凌晨 12：00，所有编辑值) 。
- Datetime 显示和编辑默认) (日期和时间。
- ISO8601 以转换为协调世界时格式的 ISO8601 时间格式显示日期和时间 (UTC) 格式：YYYY-MM-DDTHH：MM：SSZ。 这是用于 2007 年 Microsoft Office 系统中的文档属性的格式，以及 用于 SharePoint Foundation 中 New 和 Edit 窗体与服务器之间的标准交换格式。
- ISO8601Basic 使用 8601 日期/时间格式的缩写形式：YYYYMMDDTHHMMSSZ。 这是用于 vCard/iCal 的格式。

对于“选择字段”，此属性可以设置为 “下拉列表 ” (默认) （通过下拉选择提供编辑选项）或 “RadioButtons”，后者通过一组单选按钮提供选项。

对于 URL 字段，此属性可以设置为 “超链接 ” (默认) （将 URL 显示为普通 <A> 标记）或“ 图像”（将 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
可选 文本。 指定大括号 () {} 中包含的字段的 GUID。
Id
可选 文本。
IMEMode
可选属性，类型为 Text。 指定用于字段的输入法编辑器 (IME) 模式偏量。 当一个编写系统具有的字符多于可为给定键盘编码的字符时，IME 允许语言之间的键击转换。

可能的值包括：
- 自动 未使用。 若要指定此 IME 模式，请将 IMEMode 属性值设置为空字符串 ("") 。
- 积极 所有字符都通过 IME 键入，但用户仍然可以停用 IME。
- 无效 尽管用户仍然可以激活 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
可选 文本。
List
可选属性，类型为 Text。 指定列表的内部名称。
ListItemMenu
可选属性，类型为 Boolean。
ListItemMenuAllowed
可选 文本。
Max
可选属性，类型为 Number。 指定字段允许的最大值。
MaxLength
可选属性，类型为 Integer。 指定字段值中允许的字符的最大数目。 调整编辑表单以强制使用此值（将在客户端上验证此值）。 如果用户尝试输入的字符的数目多于 MaxLength 设置的字符的数目，将出现一条错误消息。
Min
可选属性，类型为 Number。 指定字段允许的最小值。
Mult
可选属性，类型为 Boolean。 在显示数字之前，在乘法中使用的比例因子。
名称
必需属性，类型为 Text。 字段的名称。 这是字段的内部名称，并且保证在字段定义的生存期内绝不会更改。 相对于列表中的字段集，它必须是唯一的。 该名称基于用户定义的字段名称自动生成。
NegativeFormat
可选属性，类型为 Text。 指定如何指示负值。 可以设置为下列值之一：
- MinusSign 使用减号作为前缀。
- Parens 用括号括起来。
Node
可选属性，类型为 Text。 在 XML 表单中使用，除了处理指令 (PI) 链接之外，此属性是所有字段必需的，它为提升的节点指定 XPath 表达式。
NoEditFormBreak
可选属性，类型为 Boolean。 若为 TRUE，则阻止在新项目表单或编辑项目表单中的字段之间添加换行符。 某些字段类型（如格式文本字段）默认情况下会提供间距，此属性可用来控制由此产生的额外间距。
NumLines
可选属性，类型为 Integer。 建议编辑过程中在 TEXTAREA 块中显示的行数。 这只是客户端用户界面提示，对于可以编辑的文本行数量没有任何强制性限制。
Percentage
可选属性，类型为 Boolean。 如果值显示为百分比，则为 TRUE；即，将数字乘以 100%。
PIAttribute
可选 文本。 指定文档处理指令（由 PITarget 属性指定）中要用作列值的属性。 用于在 XML 文档中进行属性升级和降级。 如果指定 PIAttribute 属性，则还必须指定 PITarget 属性。

有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅Using Content Types to Specify XML Document Properties。
PITarget
可选属性，类型为 Text。 指定文档处理指令，其中列值存储在此内容类型的文档中。 用于在 XML 文档中进行属性升级和降级。 如果指定 PIAttribute 属性，则还必须指定 PITarget 属性。

有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅Using Content Types to Specify XML Document Properties。
PrependId
可选属性，类型为 Boolean。 用于问题跟踪列表中，若要显示编辑和新建项目表单中相关问题项目的集合 ID，则为 TRUE。
状态
可选属性，类型为 Boolean。 如果字段中显示用户信息，则为 TRUE。
PrimaryKey
可选属性，类型为 Boolean。 如果字段为一个列表和另一个列表之间的关系中的主键，则为 TRUE。
PrimaryPIAttribute
可选属性，类型为 Text。 用于在 XML 文档中进行属性升级和降级。 指定文档处理指令（由 PrimaryPITarget 指定）中要用作列值的替换属性。 如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。 如果指定，SharePoint Foundation 将使用这些值，然后再使用 PITarget 和 PIAttribute 属性中指定的值。

有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅Using Content Types to Specify XML Document Properties。
PrimaryPITarget
可选属性，类型为 Text。 指定备用文档处理指令，其中将为此内容类型的文档存储列值。 如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。 如果指定，SharePoint Foundation 将使用这些值，然后再使用 PITarget 和 PIAttribute 属性中指定的值。

有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息，请参阅Using Content Types to Specify XML Document Properties。
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 高度。
必需
可选属性，类型为 Boolean。 如果为 TRUE，则不得对字段分配空值。 如果在表单帖子中未提供非空字段值，则错误表单中会显示标准必填字段文本或显式指定的消息 (，即通过 <ErrorText> 标记) 。 此验证仅由客户端处理（数据库始终允许所有用户自定义的字段为 NULL）。
RestrictedMode
可选属性，类型为 Boolean。 如果为 TRUE，则不允许 Note 字段包含增强的格式文本格式（例如图片、表或超链接），也不允许将格式化文本粘贴到此字段。
ResultType
可选属性，类型为 Text。 指定从字段返回的值的数据类型。
RichText
可选属性，类型为 Boolean。 如果字段显示格式文本格式，则为 TRUE。
RowOrdinal
可选属性，类型为 Integer。 指定字段的数据库位置。
密封
可选属性，类型为 Boolean。 若为某个列表的 Schema.xml 文件中的某个字段将此属性设置为 TRUE，则会在“更改列”页中将该字段标记为不可移除。
SeparateLine
可选属性，类型为 Boolean。 在内部使用以支持在单独的行中呈现字段（例如，备注或注释）。 此属性不应公用。
SetAs
不应从代码中直接使用。
ShowAddressBookButton
不应从代码中直接使用。
ShowAlways
可选属性，类型为 Boolean。
ShowField
可选。 ShowField 属性可设置为要显示的字段名称。 默认情况下，将显示来自外部列表中的记录的 Title 字段的超链接文本。 但可以使用 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 可指定字段显示在用于查看列表数据的页面中。
可排序
可选属性，类型为 Boolean。 如果可以对字段中的值进行排序，则为 TRUE。
SourceID
可选 文本。 包含定义字段的命名空间，例如 http://schemas.microsoft.com/sharepoint/v3，或在其中创建自定义字段的列表的 GUID。
StaticName
可选属性，类型为 Text。 包含字段的内部名称。
StorageTZ
指定如何存储日期/时间值。 当 StorageTZ 设置为 UTC 时，将日期/时间作为协调世界时 (UTC) 处理。 若要指示一个引用“抽象”时间的日期/时间值，也就是说在用户输入日期/时间时将其存储到数据库中，而不进行本地时区转换或存储，请忽略 StorageTZ 属性。
StripWS
可选属性，类型为 Boolean。 如果从字段值的开头和结尾移除空白，则为 TRUE。
SuppressNameDisplay
可选属性，类型为 Boolean。 若要在 User 字段中不显示用户名，则为 TRUE。
TextOnly
可选属性，类型为 Boolean。 如果为 TRUE，则字段仅可以包含 Text 值。
标题
可选属性，类型为 Text。 包含用户界面中显示的字段的标题。
类型
必需 文本。 字段的数据类型（除非 Field 元素是 ProjectedFields 的子集）。

注意：在 Microsoft SharePoint Foundation 2010 的技术预览版中，Type 属性具有不同的含义，并且当它是 ProjectedFields 的子级时，只有一个可能的值 (“Lookup”) 。 有关 Type 的此用法的详细信息，请参阅 ProjectedFields 元素 (视图) 。

默认情况下，SharePoint Foundation 包含以下数据类型：

- AllDayEvent 指定全天事件。 对应于 位 SQL 数据类型。

- 附件 存储附件的 URL。 对应于 位 SQL 数据类型。

- 布尔用于存储 / TRUEFALSE 值 (以 0 或 1) 的形式存储在数据库中。 此字段可排序且可分组。 对应于 位 SQL 数据类型，由 SPFieldBoolean 类表示。

- 计算 指定基于其他列计算其值的字段。 对应于 sql_variant SQL 数据类型，由 SPFieldCalculated 类表示。

- 选择 允许用户指定一组预先确定的值，这些值可用于将数据输入字段。 “选项”和“查找”类型是用于排序和分组的最重要字段。 BaseType 和 Format 属性可用于选择字段。 此字段可排序且可分组。 为选择选项提供值时，该值将用作字段选择的已提交值。 如果未提供任何值，该选项将作为所选内容的文本值提交。 在所有情况下，选择的文本值都是 UI (下拉列表或单选按钮文本) 显示的内容。 选项在编辑 UI 中的显示顺序始终为 在 CHOICES 元素中指定项的顺序。 使用 MultiChoice 类型指定一个 “选择” 字段，该字段实现复选框并允许用户选择多个值。 对应于 nvarchar SQL 数据类型，由 SPFieldChoice 类表示。

- 计算 指定一个字段，该字段的内容依赖于另一个字段。 例如， LinkTitleNoMenu 字段相当于使用超链接围绕标题字段值。 由 SPFieldComputed 类表示 。

- ContentTypeId 包含内容类型 ID。 有关内容类型 ID 的格式的信息，请参阅Content Type IDs。 对应于 varbinary SQL 数据类型。

- 计数器 通常仅用于内部 ID 字段。 其整数值自动设置为相对于当前列表中的所有其他项是唯一的。 计数器类型始终是只读的，不能通过表单帖子进行设置。 此字段可排序，但不可分组。 对应于 int SQL 数据类型。

- CrossProjectLink 用于将 SharePoint 列表中的事件与会议工作区网站连接;专门引用“新建”和“编辑项目”窗体中用于为项目创建会议工作区网站的复选框的字段类型。 对应于 位 SQL 数据类型，由 SPFieldCrossProjectLink 类表示。

- 货币 允许输入货币值。 每个货币字段都与特定区域设置的货币相关联。 在所有其他方面，它被视为“ 数字 ”字段类型。 使用 LCID 属性指示特定区域设置的货币。 Decimals、Max 和 Min 属性可用于货币类型。 此字段可排序且可分组。 对应于 float SQL 数据类型，由 SPFieldCurrency 类表示。

- Datetime 允许存储一天中完全限定的日期或时间。 使用 Format 属性指定日期格式设置，并使用 StorageTZ 属性确定日期/时间值的存储方式。 此字段可排序且可分组。 对于显示模式，日期格式设置的顺序派生自区域设置 (“M/D/Y”或“D/M/Y”) 。 在编辑模式 (或 默认 元素值) 的新模式下，日期/时间以通用格式呈现：M/D/Y hh：mm am/pm。 对应于 datetime SQL 数据类型，由 SPFieldDateTime 类表示。

- 文件 包含文件。 对应于 uniqueidentifier SQL 数据类型。

- GridChoice 包含调查的分级范围。 对应于 ntext SQL 数据类型，由 SPFieldRatingScale 类表示。

- Guid 允许使用全局唯一标识符 (GUID) 。 对应于 uniqueidentifier SQL 数据类型。

- 整数 允许使用正整数值或负整数值。 逗号和 NegativeFormat 属性用于指定整数格式。 对应于 int SQL 数据类型。

- 查找 行为与 Choice 字段非常相似，只不过可用选项来自另一个列表，而不是硬编码的值选择。 List 和 ShowField 属性可用于 Lookup 字段。 此字段可排序且可分组。 对于排序和分组，请使用 “标题” (DisplayField 值，默认情况下) 而不是存储在列表中的外键。 对应于 int SQL 数据类型，由 SPFieldLookup 类表示。

- LookupMulti 可以包含多个值的 查阅 字段。 父类型： 查找。

- ModStat 包含内容审批状态。 可能的值包括已 批准 (默认) 、 Rejected 和 Pending (分别存储为 0、1 或 2，) 。 对应于 int SQL 数据类型。

- MultiChoice 指定一个 选项 字段，该字段实现复选框并允许用户选择多个值。 对应于 ntext SQL 数据类型，由 SPFieldMultiChoice 类表示。

- MultiColumn 模拟包含多个值的字段的 Note 字段。 有关多列字段类型的示例，请参阅 自定义字段类型定义。 有关多列字段的信息，请参阅 自定义多列字段类。 父类型： 注意。

- 注意 允许用户输入多行文本。 此字段不可排序或分组。 所有文本定义为不带 HTML 标记的直 ASCII 字符。 看起来像 HTML 标记或 URL 的任何内容都只是用引号 (例如 Server.HTMLEncode) 看起来像是直文本。 用于编辑此格式的控件是一个简单的 TEXTAREA 块。 使用 NumLines 属性指定要显示的行数。 对应于 ntext SQL 数据类型，由 SPFieldMultiLineText 类表示。

- 数量 允许输入浮点数。 此字段可排序且可分组。 根据小数点和千位分隔符的当前区域设置分析输入的数字。 负数可以通过用括号括起来或使用负号来表示。 以下属性可与 Number 属性结合使用，以指定数字格式： Decimals、 Div、 Max、 Min、 Mult 和 Percentage。 对应于 float SQL 数据类型，由 SPFieldNumber 类表示。

- PageSeparator 在调查列表中插入分页符。 由 SPFieldPageSeparator 类表示。

- 复发 用于编辑和定义事件列表中的项的重复模式。 对应于 位 SQL 数据类型。

- 文本 在编辑框中输入的单行文本。 此字段可排序且可分组。 使用 MaxLength 属性可设置允许的最大字符数。 对应于 nvarchar SQL 数据类型，由 SPFieldText 类表示。

- ThreadIndex 包含指示消息在会话线程中的相对位置的 ID。 对应于 varbinary SQL 数据类型。

- 线程线程字段类型用于创建和显示类似线程讨论的视图。 任何列表都可以包含线程列，但使用时会生成一个特殊的 UI。 (它永远不会显示为窗体中的标准可编辑字段，也不会显示为 view 中的普通列。) 如果对线程字段执行排序，则会返回父子关系中所有记录的预排序遍历。 这是通过保存特定记录的所有父记录的创建日期和 ID 号串联来实现的。 对应于 varchar SQL 数据类型。

- Url 用于创建任意格式超链接。 URL 字段显示为 <A HREF="URL">Description</A>。 如果未提供任何说明，则它显示为 <A HREF="URL">URL</A>。 URL 文本本身存储在 DocMd) 表 (URL 中，该表将所有 URL 存储在服务器上的 SharePoint 数据库中。 这样做是为了在目标移动时，可以通过链接修复更新服务器上的任何本地 URL。 删除包含 URL 字段的记录时，也会删除 URL 表中的相应引用记录。 此字段可排序且可分组。 (排序是根据文本说明而不是 URL 的内容定义的;如果未提供说明，则其排序方式与 blank 相同。) 当 Type 为 URL 时， LinkType 属性可用于指定链接的类型。 对应于 nvarchar SQL 数据类型，由 SPFieldUrl 类表示。

- 用户 引用 UserInfo 数据库表的 Lookup 字段。 对应于 int SQL 数据类型，由 SPFieldUser 类表示。

- UserMulti 可以包含多个值的 User 字段。 父类型： LookupMulti。

- WorkflowEventType 指定由 SPWorkflowHistoryEventType 枚举表示的工作流事件类型。 父类型： 整数。

- WorkflowStatus 指定 由 SPWorkflowStatus 枚举表示的工作流状态。 对应于 nvarchar SQL 数据类型。
UniqueId
可选属性，类型为 Text。 不应从代码中直接使用。
UnlimitedLengthInDocumentLibrary
可选属性，类型为 Boolean。 若要允许文档库中的字段长度不受限制，则为 TRUE。
URLEncode
可选属性，类型为 Boolean。 如果为 TRUE ，可将特殊字符（如空格）转换为带引号的 UTF-8 格式，例如字符 %c3%abë。
URLEncodeAsURL
可选属性，类型为 Boolean。 与 URLEncode 类似，但 为 TRUE ，指定要编码的字符串是 URL 的路径组件，以便不编码 (/) 的正斜杠。
UserSelectionMode
可选属性，类型为 Text。 指定是只能在项目表单上的用户字段中选择单个用户的名称，还是可以同时选择个人和组的名称。 可能的值包括：
0 - 只能选择个人名称。
1 - 可以同时选择个人和组的名称。
UserSelectionScope
可选属性，类型为 Integer。 指定一个范围，以便在项目表单上的用户字段中选择用户名。 如果值为 0，则对 SharePoint 组没有限制。 如果值大于 0，则用户选择仅限于其 ID 等于指定值的 SharePoint 组的成员。
版本
可选 文本。
可见
可选属性，类型为 Boolean。 若要指定将字段添加到默认视图中，则为 TRUE。 默认值为 TRUE 。
WebId
可选 文本。
Width
可选属性，类型为 Integer。 指定为用户信息列表中的用户显示的图像的宽度（以像素为单位）。
WikiLinking
可选属性，类型为 Boolean。 如果为 TRUE ，则指定以双括号形式显示的 wiki 链接（ ([[…]]) ）转换为使用 标记的 <A> HTML 链接。
XName
可选属性，类型为 Text。 在 XML 表单内部使用以标识已添加、删除或修改的字段。 此属性不应公用。

子元素

父元素

出现次数

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

备注

若要为基于默认 SharePoint Foundation 字段类型的列表定义创建自定义字段定义，请在Schema.xml 文件中使用 Field (List - Definition) 元素。

若要创建自定义字段定义作为基于默认字段类型的可插入功能，并且可以跨网站集内的网站和列表重复使用，请使用 Field (Field) 元素来定义自定义 网站列。

若要创建为特定数据有效性和字段呈现实现自定义类的自定义字段类型，请使用 Field（字段类型）元素。

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

用于引用字段的语法如下所示：

<Field Name="FieldName"/>

默认情况下，使用上表中指定的字段定义的默认属性呈现字段。 任何字段属性都可以在 FieldRef 属性的 CAML 标记中重写，该标记替代为字段本身提供的定义， (字段的 Type 属性不能) 更改。

若要显示字段的用户定义显示名称，可以使用 <Property Select="DisplayName"/>。

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

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

除了上述类型之外，还使用以下预定义字段与 Field 元素一起使用：


名称 说明
创建时间
包含 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。 标题是为要列出的 Lookup 字段显示的默认文本。
LinkTitle
显示指向项目的超链接的计算字段，其中包含标题文本并生成指向项目的 URL（和新的图标引用）。 此字段没有任何额外的存储区；它依靠 ID 字段和 Title 字段来呈现其用户界面。

注意

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

示例

以下示例使用 Field 元素为名为 Area list 的列表指定选项：

<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>

另请参阅