定义在 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" Commas = "TRUE" | "FALSE" Decimals = "Integer" Description = "Text" Dir = "Text" DisplaceOnUpgrade = "TRUE" | "FALSE" DisplayImage = "Text" DisplayName = "Text" DisplayNameSrcField = "Text" Div = "Number" EnableLookup = "TRUE" | "FALSE" ExceptionImage = "Text" FieldRef = "Text" FillInChoice = "TRUE" | "FALSE" Filterable = "TRUE" | "FALSE" FilterableNoRecurrence = "TRUE" | "FALSE" ForcedDisplay = "Text" Format = "Text" FromBaseType = "TRUE" | "FALSE" Group = "Text" HeaderImage = "Text" Height = "Integer" Hidden = "TRUE" | "FALSE" HTMLEncode = "TRUE" | "FALSE" ID = "Text" IMEMode = "inactive" Indexed = "TRUE" | "FALSE" IsolateStyles = "TRUE" | "FALSE" JoinColName = "Text" JoinRowOrdinal = "Integer" JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER" LCID = "Integer" List = "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" 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" 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 属性,该属性指定要对返回的值集合执行的操作。此操作可以是一个聚合函数,也可以是集合中特定元素的指示。 可能的值包括:
有关如何在 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。指定日历类型。可能的值包括:
|
CanToggleHidden | 可选属性,类型为 Boolean。如果可以通过用户界面隐藏字段,则为 TRUE。 |
ClassInfo | 可选属性,类型为 Text。指定用于标准表视图中的字段的级联样式表 (CSS) 类。如果进行了设置,则将会使用指定的类,而不使用标准的 ms-vb2 类。 |
ColName | 可选属性,类型为 Text。一个内部属性,定义字段与此字段的物理存储名称之间的映射。这必须是基础数据库中的有效名称,并且必须与数据库表中使用的名称相同。如果未指定,则服务器将生成一个列名称,此列名称不会与任何现有列名称发生冲突并只包含 Microsoft SQL Server 允许的字符。 |
Commas | 可选属性,类型为 Boolean。如果使用逗号来分隔千位,则为 TRUE。 |
Decimals | 可选属性,类型为 Integer。确定要显示的小数位数。将根据显示精度对显示的值进行四舍五入;例如,若四舍五入到一位小数,则 1.05 将显示为 1.1。 |
Description | 可选属性,类型为 Text。提供在列表的编辑表单中显示的说明(如果已指定字段说明)。默认情况下,Windows SharePoint Services 中的字段没有说明。 |
Dir | 可选属性,类型为 Text。指定支持双向读取顺序的字段的文本方向。可能的值为 LTR(从左到右)、RTL(从右到左)和 none。 |
DisplaceOnUpgrade | 可选属性,类型为 Boolean。如果字段已存在字段定义,则为 TRUE,以强制使用字段定义中指定的值更新字段属性。 |
DisplayImage | 可选属性,类型为 Text。指定为列显示的图标的名称。 |
DisplayName | 可选属性,类型为 Text。字段的显示名称。对于文字大小或空格的使用,不存在任何限制。显示名称可以由用户编辑,并可以在初次创建字段后发生更改。当字段在表视图中显示时,此名称将用作列标题;当字段在表单中显示时,此名称将用作表单标签。如果给定一个显示名称,则 < FieldName / > 标记返回该显示名称;否则,它将默认返回 Name 属性中的名称。 |
DisplayNameSrcField | 可选属性,类型为 Text。通常用于需要与另一个字段具有相同名称的计算字段。如果用户已修改源字段并更改显示名称,则此字段的显示名称也将发生更改。该字符串引用其他字段的名称。 |
Div | 可选属性,类型为 Number。在显示数目之前,除法中使用的比例因子。显示数目为 N * Mult / Div(四舍五入到 Decimals 指定的数目)。 |
EnableLookup | 可选属性,类型为 Boolean。若要启用字段中的查找值,则为 TRUE。 |
ExceptionImage | 可选属性,类型为 Text。在 Recurrence 字段类型中使用,以指定要用于例外情况的图像文件的名称。 |
FieldRef | 可选属性,类型为 Text。指定字段所引用的另一个字段(例如,查阅字段)的名称。 |
FillInChoice | 可选属性,类型为 Boolean。如果字段允许用户填写列值,则为 TRUE。 |
Filterable | 可选属性,类型为 Boolean。如果可以对字段进行筛选,则为 TRUE。 |
FilterableNoRecurrence | 可选属性,类型为 Boolean。如果可以对未扩展定期事件的视图中的字段创建筛选器,则为 TRUE。如果 Filterable 包含 TRUE,则可以在所有视图中对字段进行筛选,而与如何设置 FilterableNoRecurrence 无关。 |
ForcedDisplay | 可选属性,类型为 Text。指定要显示的文本,此文本将代替实际字段值。在调查中使用此属性可阻止显示用户名。 |
Format | 可选属性,类型为 Text。指定用于数值的格式。 对于日期/时间字段,可能是下面的值:
对于 Choice 字段,此属性可设置为 Dropdown(默认值),这将通过下拉选项提供编辑选项;也可以设置为 RadioButtons,这将通过一组单选按钮提供选项。 对于 URL 字段,此属性可设置为 Hyperlink(默认值),这会将 URL 显示为常规的 <A> 标记;也可以设置为 Image,这会将 URL 显示为 |
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 允许语言之间的键击转换。 可能的值包括:
|
Indexed | 可选属性,类型为 Boolean。如果编制列索引以用于视图筛选器,则为 TRUE。 |
IsolateStyles | 可选属性,类型为 Boolean。对于其 RichText 属性为 TRUE 且 RichTextMode 属性为 FullHtml 的 Text 字段,此属性指定服务器将重写此字段的 HTML 以确保它不会干扰周围页面的呈现。 |
JoinColName | 可选属性,类型为 Text。仅为 Lookup 字段定义此属性。除了指示在本地和外部列表之间的 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。 |
List | 可选属性,类型为 Text。指定列表的内部名称。 |
Max | 可选属性,类型为 Number。指定字段允许的最大值。 |
MaxLength | 可选属性,类型为 Integer。指定字段值中允许的字符的最大数目。调整编辑表单以强制使用此值(将在客户端上验证此值)。如果用户尝试输入的字符的数目多于 MaxLength 设置的字符的数目,将出现一条错误消息。 |
Min | 可选属性,类型为 Number。指定字段允许的最小值。 |
Mult | 可选属性,类型为 Boolean。在显示数字之前,在乘法中使用的比例因子。 |
Name | 必需属性,类型为 Text。字段的名称。这是字段的内部名称,并且保证在字段定义的生存期内绝不会更改。相对于列表中的字段集,它必须是唯一的。该名称基于用户定义的字段名称自动生成。 |
NegativeFormat | 可选属性,类型为 Text。指定如何指示负值。可以设置为下列值之一:
|
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 属性。如果指定,则 Windows SharePoint Services 会在 PITarget 和 PIAttribute 属性中指定的值之前使用这些值。 有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息,请参阅使用内容类型指定 XML 文档属性。 |
PrimaryPITarget | 可选属性,类型为 Text。指定备用文档处理指令,其中将为此内容类型的文档存储列值。如果指定 PrimaryPIAttribute 属性,则还必须指定 PrimaryPITarget 属性。如果指定,则 Windows SharePoint Services 会在 PITarget 和 PIAttribute 属性中指定的值之前使用这些值。 有关如何在 XML 文档中使用 Node、PIAttribute、PITarget、Primary PIAttribute 和 PrimaryPITarget 属性进行属性升级和降级的详细信息,请参阅使用内容类型指定 XML 文档属性。 |
ReadOnly | 可选属性,类型为 Boolean。如果为 TRUE,则字段不会在新建表单或编辑表单中显示,但可以包含在视图中。此外,将 ReadOnly 设置为 TRUE,可以在用于管理网站列和内容类型的网站设置页上隐藏字段。若将 Hidden 属性设置为 TRUE,则会在用户界面上完全隐藏字段。如果不包括此属性,则 Windows SharePoint Services 会按照此属性设置为 False 的情况处理列。 |
ReadOnlyEnforced | 可选属性,类型为 Boolean。若要指定用户无法通过任何方式更改字段,只有系统才能更改此字段,则为 TRUE。 |
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 | 不应从代码中直接使用。 |
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。包含定义字段的命名空间(如 |
StaticName | 可选属性,类型为 Text。包含字段的内部名称。 |
StorageTZ | 指定如何存储日期/时间值。当 StorageTZ 设置为 UTC 时,将日期/时间作为协调世界时 (UTC) 处理。若要指示一个引用“抽象”时间的日期/时间值,也就是说在用户输入日期/时间时将其存储到数据库中,而不进行本地时区转换或存储,请忽略 StorageTZ 属性。 |
StripWS | 可选属性,类型为 Boolean。如果从字段值的开头和结尾移除空白,则为 TRUE。 |
SuppressNameDisplay | 可选属性,类型为 Boolean。若要在 User 字段中不显示用户名,则为 TRUE。 |
TextOnly | 可选属性,类型为 Boolean。如果为 TRUE,则字段仅可以包含 Text 值。 |
Title | 可选属性,类型为 Text。包含用户界面中显示的字段的标题。 |
Type | 必需属性,类型为 Text。字段的数据类型。默认情况下,Windows SharePoint Services 包括以下数据类型:
|
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 组的成员。 |
Viewable | 可选属性,类型为 Boolean。若要指定将字段添加到默认视图中,则为 TRUE。默认值为 TRUE。 |
Width | 可选属性,类型为 Integer。指定为用户信息列表中的用户显示的图像的宽度(以像素为单位)。 |
WikiLinking | 可选属性,类型为 Boolean。若要指定将以双层括号 ([[…]]) 形式显示的 Wiki 链接转换为使用 <a> 标记的 HTML 链接,则为 TRUE。 |
XName | 可选属性,类型为 Text。在 XML 表单内部使用以标识已添加、删除或修改的字段。此属性不是公共属性。 |

