Field 元素（字段）

2015-06-15

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

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素

定义网站栏。

<Field
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion="TRUE" | "FALSE"
  AllowDuplicateValues="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"
  Commas="TRUE" | "FALSE"
  Customization=Text
  Decimals="Integer"
  DefaultListField="TRUE" | "FALSE"
  Description="Text"
  Dir="Text"
  DisplaceOnUpgrade="TRUE" | "FALSE"
  DisplayImage="Text"
  DisplayName="Text"
  DisplayNameSrcField="Text"
  DisplaySize=Integer
  Div="Number"
  EnableLookup="TRUE" | "FALSE"
  ExceptionImage="Text"
  FieldRef="Text"
  FillInChoice="TRUE" | "FALSE"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  ForcedDisplay="Text"
  Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
  FromBaseType="TRUE" | "FALSE"
  Group="Text"
  HeaderImage="Text"
  Height="Integer"
  Hidden="TRUE" | "FALSE"
  HTMLEncode="TRUE" | "FALSE"
  ID="Text"
  IMEMode="active | 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"
  List="Text"
  Max="Number"
  MaxLength="Integer"
  Min="Number" 
  Mult="TRUE" | "FALSE"
  Name="Text"
  NegativeFormat="MinusSign" | "Parens"
  Node="Text"
  NoEditFormBreak="TRUE" | "FALSE"
  NumLines="Integer"
  Overwrite="TRUE" | "FALSE"
  OverwriteInChildScopes="TRUE" | "FALSE"
  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="Restrict | Cascade | None"
  RenderXMLUsingPattern="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  RestrictedMode="TRUE" | "FALSE"
  ResultType="Text"
  RichText="TRUE" | "FALSE"
  RichTextMode="Text"
  RowOrdinal="Integer"
  Sealed="TRUE" | "FALSE"
  SeperateLine="TRUE" | "FALSE"
  SetAs="Text"
  ShowAddressBookButton="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"
  Viewable="TRUE" | "FALSE"
  Width="Integer"
  WikiLinking="TRUE" | "FALSE"
  XName="Text">
</Field>

属性

属性	说明
Aggregation	可选属性，类型为 Text。在 XML 表单上的聚合字段中用于指定要应用于 XPath 表达式返回的值或元素集合的函数。如果使用 Node 属性指定返回值集合的 XPath 表达式，还可以包括 Aggregation 属性，该属性指定对返回的值集采取的操作。此操作可以是一个聚合函数，也可以是集合内特定元素的指示法。可能的值包括： sum 添加值。 count 计算值的数目。 average 求值的平均数。 min 查找最小值。 max 查找最大值。 merge 合并值。 plaintext 将节点文本内容转换为纯文本。 first 对集合中的第一个元素应用属性升级和降级。 last 对集合中的最后一个元素应用属性升级和降级。有关 Node、PIAttribute、PITarget、Primary、PIAttribute 和 PrimaryPITarget 属性在 XML 文档中如何用于属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
AllowDeletion	可选属性，类型为 Boolean。如果该字段可删除，则为 TRUE。
AllowDuplicateValues	可选属性，类型为 Boolean。指定是否允许在给定的列表字段中使用重复值。将该值设置为 false（不允许输入重复值）能使此字段的行为类似于主键。如果允许在字段中使用重复值，则为 True；否则为 false。默认值为 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 所允许的字符。
Commas	可选属性，类型为 Boolean。如果使用逗号分隔千位，则为 TRUE。
Customization	可选属性，类型为 Text。提供向自定义字段类型添加自定义属性的功能。
Decimals	可选属性，类型为 Integer。确定要显示的小数位数。显示的值向上舍入到该显示精度；例如，1.05 四舍五入到一个小数位时显示为 1.1。
DefaultListField	可选属性，类型为 Boolean。获取一个值，指定将某个文件上载到文档库时，是否显示该文件的"编辑属性"表单。如果添加到库的字段不显示"编辑属性"表单，则为 True；否则，为 false。默认值为 false。
Description	可选属性，类型为 Text。如果指定了字段描述，则为列表提供编辑表单中显示的描述。默认情况下，Microsoft SharePoint Foundation 中的字段没有描述。
Dir	可选属性，类型为 Text。为支持双向阅读顺序的字段指定文本方向。可能值为 LTR（从左到右）、RTL（从右到左）和 none。
DisplaceOnUpgrade	可选属性，类型为 Boolean。如果字段已存在字段定义，则选择 TRUE 可强制使用该字段定义中指定的值更新字段属性。
DisplayImage	可选属性，类型为 Text。指定栏的显示图标名称。
DisplayName	可选属性，类型为 Text。字段的显示名称。没有空格使用限制。最大长度为 255 个字符。该值可以是格式为 $Resources:String 的资源引用。有关详细信息，请参阅本地化 SharePoint 解决方案（该链接可能指向英文页面）。该显示名称可由用户编辑并且可在初始字段创建后更改。该名称在字段显示在表视图中时用作栏标题，在字段显示在表单中时用作表单标签。
DisplayNameSrcField	可选属性，类型为 Text。通常用于需要与另一个字段名称相同的计算字段。如果修改了源字段且用户更改了显示名称，则该字段的显示名称也将更改。此字符串引用其他字段的名称。
DisplaySize	可选属性，类型为 Integer。
Div	可选属性，类型为 Number。显示数值前在除式中使用的比例因子。显示的数值为 N * Mult / Div（向上舍入到 Decimals 指定的位数）。
EnableLookup	可选属性，类型为 Boolean。选择 TRUE 可在字段中启用查找值。
ExceptionImage	可选属性，类型为 Text。用于在 Recurrence 字段类型中指定用于异常的图像文件的名称。
FieldRef	可选属性，类型为 Text。对于次查阅字段，指定其所依赖的主查阅字段的 ID。该值应为没有括号的 GUID 字符串表示。
FillInChoice	可选属性，类型为 Boolean。如果字段允许用户为栏填充值，则为 TRUE。
Filterable	可选属性，类型为 Boolean。如果可过滤字段，则为 TRUE。
FilterableNoRecurrence	可选属性，类型为 Boolean。如果可以在不扩展定期事件的视图中的字段中创建筛选器，则为 TRUE。如果 Filterable 包含 TRUE，则不管 FilterableNoRecurrence 如何设置，都可在所有视图中过滤该字段。
ForcedDisplay	可选属性，类型为 Text。指定要取代实际字段值显示的文本。该属性用于在调查中阻止显示用户名。
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 的格式。对于单选字段，此属性可设置为 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 的字符串表示形式。
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。如果该字段由 GetRelatedFields() 方法从另一个列表返回，则为 TRUE。
JoinColName	可选属性，类型为 Text。仅针对查阅字段定义此属性。除了表示用于本地和外部列表之间 SQL JOIN 中的栏的名称，该属性与 ColName 非常相似。通常，不应自定义该值。其目前仅用于在特定内置和基类型字段的字段架构中来指示对 URL (DocMd) 表（它会加入到"UrlI"栏上）的查阅。
JoinRowOrdinal	可选属性，类型为 Integer。不应直接从您的代码中使用。
JoinType	可选属性，类型为 Text。指定在该字段上使用的 JOIN 的类型。可能值包括：INNER、LEFTOUTER 和 RIGHTOUTER。
LCID	可选属性，类型为 Integer。LCID 属性可用于指定所用货币格式所属的国家/地区，例如 1033 代表美国。有两种涉及欧元符号格式的特殊情况。如果 LCID=-1 (0xFFFFFFF)，则会作为数值的前缀添加欧元符号。如果 LCID=-2 (0xFFFFFFE)，则会作为数值的后缀添加欧元符号。小数位数是 2，但是可由该字段的 Decimals 属性替代。在 UCS-2 中，欧元货币符号等于 0x20AC。
List	可选属性，类型为 Text。用于标识查阅字段 (Type="Lookup") 的目标列表。如果目标列表已存在，List 属性的值应是标识目标列表的 GUID 的字符串表示（包括括号）。如果目标列表与该字段所属的列表相同，则可以指定"自身"。如果目标列表不存在，List 属性的值可以是相对于网站的 URL（例如"Lists/My List"），但只有在创建目标列表与创建查阅字段所用的功能相同时才适用。在这种情况下，Field 元素上 List 属性的值必须等于创建目标列表的 ListInstance 元素上的 Url 属性的值。
Max	可选属性，类型为 Number。指定该字段允许的最大值。
MaxLength	可选属性，类型为 Integer。指定字段值中允许的字符的最大数目。调整编辑表单以强制使用此值（将在客户端上验证此值）。如果用户尝试输入的字符的数目多于 MaxLength 设置的字符的数目，将出现一条错误消息。
Min	可选属性，类型为 Number。指定该字段允许的最大值。
Mult	可选属性，类型为 Boolean。选择 TRUE 可允许查阅字段包含多个值。默认值为 FALSE。
Name	必需属性，类型为 Text。字段的内部名称。该名称在列表或网站的字段集中必须为唯一。如有必要，SharePoint Foundation 会修改该值以保证其唯一性；否则，在字段定义的生命周期内，其不会更改。
NegativeFormat	可选属性，类型为 Text。指示如何表示负值。可以设置为以下值之一： MinusSign 使用减号作为前缀。 Parens 围上括号。
Node	可选属性，类型为 Text。用于 XML 表单中，除了处理指令 (PI) 链接，其他所有字段都需要该属性，它指定升级的节点提供 XPath 表达式。
NoEditFormBreak	可选属性，类型为 Boolean。选择 TRUE 可阻止在新项目表单或编辑项目表单中的字段间添加换行符。某些字段类型（如格式文本字段）默认提供间隔，此属性允许控制产生的多余间隔。
NumLines	可选属性，类型为 Integer。建议编辑期间显示在 TEXTAREA 块中的行数。这只是客户端 UI 提示 — 对可以编辑的文本行数没有限制。
Overwrite	可选属性，类型为 Boolean。指定当新字段与现有字段具有相同的字段 ID 时，是否使用在网站 (SPWeb) 上激活的新字段的字段定义来覆盖现有字段的字段定义。如果新字段覆盖具有相同字段 ID 的现有字段，则为 True；否则为 false。默认值为 false。但请注意，如果现有字段是只读字段或是密封字段，则即使该属性设置为 true，它也不会被要激活的字段覆盖。
OverwriteInChildScopes	可选属性，类型为 Boolean。指示在设置网站集中的字段时，如果指定的字段定义已存在于该网站集的子网站中，是否要覆盖该字段定义。如果应覆盖该网站定义，则为 True；否则为 false。默认值为 false。
Percentage	可选属性，类型为 Boolean。如果该值显示为百分比，即数值乘以 100 并附加百分比符号 (%) ，则为 TRUE 。
PIAttribute	可选属性，类型为 Text。指定文档处理指令（由 PITarget 属性指定）中要用作栏值的属性。用于 XML 文档中的属性升级和降级。如果指定 PrimaryPITarget 和 PrimaryPIAttribute 属性，则还必须指定 PITarget 和 PIAttribute 属性。有关 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性如何用于 XML 文档中的属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PITarget	可选属性，类型为 Text。指定此内容类型的文档中存储栏值的文档处理指令。用于 XML 文档中的属性升级和降级。如果指定 PIAttribute 属性，则还必须指定 PITarget 属性。有关 Node、 PIAttribute、PITarget、 Primary PIAttribute 和 PrimaryPITarget 属性如何用于 XML 文档中的属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PrependId	可选属性，类型为 Boolean。由可拥有多个值的查阅字段使用。指定 TRUE 可显示目标项目的项目 ID 以及编辑和新建项目表单中目标字段的值。
Presence	可选属性，类型为 Boolean。如果存在该字段的用户信息，则为 TRUE。
PrimaryKey	可选属性，类型为 Boolean。如果该字段是该列表和另一个列表之间关系中的主键，则为 TRUE。
PrimaryPIAttribute	可选属性，类型为 Text。用于 XML 文档中的属性升级和降级。指定文档处理指令（由 PrimaryPITarget 指定）中用作栏值的替代属性。如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。如果指定，则 SharePoint Foundation 在PITarget 和 PIAttribute 属性指定的值之前使用这些值。有关 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性如何用于 XML 文档中的属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
PrimaryPITarget	可选属性，类型为 Text。为此内容类型的文档指定存储栏值的替代文档处理指令。如果指定 PrimaryPIAttribute 属性，则还必须指定 PrimaryPITarget 属性。如果指定，则 SharePoint Foundation 在 PITarget 和 PIAttribute 属性中指定的值之前使用这些值。有关 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性如何用于 XML 文档中属性升级和降级的详细信息，请参阅使用内容类型指定 XML 文档属性。
ReadOnly	可选属性，类型为 Boolean。如果为 TRUE，则字段不显示在新建或编辑表单中，但可包含在视图中。此外，将 ReadOnly 设置为 TRUE 会使字段从用于管理网站栏和内容类型的"网站设置"页中隐藏。将 Hidden 属性设置为 TRUE 会从 UI 中完全隐藏该字段。如果您不包括此属性，则 SharePoint Foundation 会以该属性设置为 False 的方式对待栏。
ReadOnlyEnforced	可选属性，类型为 Boolean。选择 TRUE 可指定用户无法以任何方式更改字段，仅可由系统更改字段。
RelationshipDeleteBehavior	可选属性，类型为 Text。指定查阅字段的删除约束。有关详细信息，请参阅 SPRelationshipDeleteBehavior 枚举。对于网站栏，该值必须为 Cascade 或 Restrict。它可以是 None（默认值），或者可忽略该属性。如果您指定 None 之外的任何其他值，则还必须为 Indexed 和 Mult 属性分别指定 TRUE 和 FALSE。
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。对于将该字段标记为不可删除字段的字段，将此属性设置为 TRUE。"更改栏"页中没有"删除"按钮。用户无法删除该字段。
SeparateLine	可选属性，类型为 Boolean。内部使用以支持在单独行中呈现字段（例如备注或注释）。此属性不应公用。
SetAs	不应直接从您的代码中使用。
ShowAddressBookButton	不应直接从您的代码中使用。
ShowField	可选属性，类型为 Text。当 Type 属性是"查阅"时，ShowField 属性指定要查阅的目标字段的名称。如果未指定值，则将显示来自目标列表中记录的"标题"字段的超链接文本。以下字段类型允许用作查阅字段的目标字段：Counter、DateTime、Number 和 Text。如果启用了查阅，则 Computed 字段类型可用作目标字段。有关详细信息，请参阅 SPFieldComputed 类的 EnableLookup 属性。如果输出是文本，则 Calculated 字段类型可用作目标字段。有关详细信息，请参阅 SPFieldCalculated 类的 OutputType 属性。
ShowInDisplayForm	可选属性，类型为 Boolean。选择 TRUE 可在用于查看项目的表单中显示字段。
ShowInEditForm	可选属性，类型为 Boolean。选择 TRUE 可在用户编辑项目的表单中显示字段。
ShowInFileDlg	可选属性，类型为 Boolean。此属性仅对文档库架构内的字段有效。如果为 FALSE，则字段不会在从客户端应用程序保存表单时所出现的属性对话框中显示。例如，"标题"字段具有该属性，因为其是直接在保存到文档库中的文档中设置的。
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。包含可能在字段集中不是唯一的字段内部名称。但是，与可能会被修改以确保其唯一性的 Name 属性不同，StaticName 属性的值会按照您的定义准确分配到该字段。之后，您可以使用此代码值通过调用 TryGetFieldByStaticName 方法获取对该字段的引用。
StorageTZ	指定日期/时间值的存储方式。当 StorageTZ 设置为 UTC 时，日期/时间作为协调世界时 (UTC) 处理。为了表示日期/时间值是指"抽象"时间，即该日期/时间在用户输入时未转换或存储本地时区而存储在数据库中，请忽略 StorageTZ 属性。
StripWS	可选属性，类型为 Boolean。如果从字段值的开头和结尾删除了空格，则为 TRUE。
SuppressNameDisplay	可选属性，类型为 Boolean。选择 TRUE 可不在 User 字段中显示用户名称。
TextOnly	可选属性，类型为 Boolean。如果为 TRUE，则字段只可包含 Text 值。
Title	可选属性，类型为 Text。包含显示在用户界面中的字段标题。
Type	必需属性，类型为 Text。字段的数据类型（除非 Field 元素是 ProjectedFields 的子元素）。备注在 Microsoft SharePoint Foundation 2010 的技术预览版本中，Type 属性具有不同的含义，并且在它是 ProjectedFields 的子元素时仅有一个可能值（"查阅"）。有关 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 属性可用于单选字段。该字段可排序和分组。如果为单选选项指定一个值，则该值将用作字段选项的提交值。如果未指定值，该选项将作为选项的文本值提交。在所有情况下，选项的文本值是显示在 UI 中的值（下拉列表或单选按钮文本）。选项在编辑 UI 中的显示顺序始终为在 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 值（默认为"标题"）而不是存储在列表中的外键。对应于 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 字段类型用于以线索组织的讨论式视图的创建和显示。任何列表都可包含线程栏，但使用它时会生成一个特殊的 UI。（它不会在表单中显示为标准可编辑字段，也不会在视图中显示为正常栏。）如果对线程字段执行排序，将返回处于父子关系中的所有记录的前序遍历。这通过保存特定记录的所有父记录的创建日期和 ID 编号的串联来完成。对应于 varchar SQL 数据类型。 URL 用于创建自由形态的超链接。URL 字段显示为 <A HREF="URL">描述</A>。如果未提供描述，则其显示为 <A HREF="URL">URL</A>。URL 文本自身存储在 URL (DocMd) 表中，此表存储了服务器上 SharePoint 数据库中的所有 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。选择 TRUE 可将特殊字符（如空格）转换为引用的 UTF-8 格式，例如字符 ë 转换为 %c3%ab。
URLEncodeAsURL	可选属性，类型为 Boolean。类似于 URLEncode，但选择 TRUE 可指定要编码的字符串为 URL 的路径组件，以便不会对斜线 ("/") 编码。
UserSelectionMode	可选属性，类型为 Text。指定是仅可在项目表单上的用户字段中选择单个用户的名称，还是可同时选择单个用户和用户组的名称。可能值有： 0 - 只可选择单个用户的名称。 1 - 可同时选择单个用户和用户组的名称。
UserSelectionScope	可选属性，类型为 Integer。指定在项目表单上的用户字段中选择用户名的范围。如果值为 0，择对 SharePoint 组没有限制。如果值大于 0，则用户选择限制为 ID 等于所指定值的 SharePoint 组成员。
Viewable	可选属性，类型为 Boolean。选择 TRUE 可指定该字段添加到默认视图。默认值为 TRUE。
Width	可选属性，类型为 Integer。以像素为单位指定在"用户信息"列表中显示的用户图像的宽度。
WikiLinking	可选属性，类型为 Boolean。选择 TRUE 可指定以双括号形式 ([[…]]) 显示的 Wiki 链接转换为使用 <a> 标记的 HTML 链接。
XName	可选属性，类型为 Text。在 XML 表单内部用于标识已添加、删除或修改的字段。此属性不应公用。

子元素

父元素

Elements

备注

重要信息
定义自定义字段时，要使字段正确显示在 Microsoft SharePoint Foundation 中，您必须指定字段的 ID、类型、名称、显示名称和组属性。Microsoft Visual Studio 中的语句完成错误地指示仅需要其中前三个属性，但事实上需要全部五个属性。

示例

下面的示例演示用于创建三个网站栏的功能对应的元素清单。

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">

  <Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
         Name="Amount"
         DisplayName="Amount"
         Type="Currency"
         Decimals="2"
         Min="0"
         Required="FALSE"
         Group="Financial Columns" />

  <Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
         Name="CostCenter"
         DisplayName="Cost Center"
         Type="Choice"
         Required="FALSE"
         Group="Financial Columns">
    <CHOICES>
      <CHOICE>Administration</CHOICE>
      <CHOICE>Information</CHOICE>
      <CHOICE>Facilities</CHOICE>
      <CHOICE>Operations</CHOICE>
      <CHOICE>Sales</CHOICE>
      <CHOICE>Marketing</CHOICE>
    </CHOICES>
  </Field>

  <Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
         Name="DateOpened"
         DisplayName="Date Opened"
         Type="DateTime"
         Format="DateOnly"
         Required="FALSE"
         Group="Financial Columns">
    <Default>[today]</Default>
  </Field></Elements>

请参阅

通过

Field 元素（字段）

属性

子元素

父元素

备注

示例

请参阅

引用

概念

其他资源

其他资源