FieldRef 元素 (查询)

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

表示对查询中的字段的引用。

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性	说明
Alias	可选 文本。
升序	可选属性，类型为 Boolean。 指定有关视图中定义的 FieldRef 元素的排序顺序。 默认值为 TRUE 。
CreateURL	可选属性，类型为 Text。 指定用于创建会议工作区网站的 .aspx 文件的 URL。
DisplayName	可选属性，类型为 Text。 此属性提供将引用的字段的显示名称。
Explicit	可选属性，类型为 Boolean。 仅在 ViewFields 元素中支持此属性。 如果在视图定义中显式声明此字段，并且此字段在视图内的 Fields 枚举中未返回，则为 TRUE。
Format	可选 文本。
ID	可选属性，类型为 Text。 指定标识字段的 GUID。
Key	可选 文本。 如果设置为 Primary，则指定该字段为其表的主键，因此将唯一标识表中的每条记录。
List	可选 文本。 FieldRef 元素是 Join 元素中 Eq 元素的子项时，指定父外部列表。 值是 Join 元素的 ListAlias 属性定义的列表别名。
LookupId	可选属性，类型为 Boolean。 当字段为 Lookup 类型时，指定查询应按其唯一项 ID 而不是字段值查找项。 例如，当多个项目在字段中具有相同的值，并且你想要查询特定项时，这很有用。 默认值为 false。
名称	可选属性，类型为 Text。 此属性提供将引用的字段的内部名称。
RefType	可选属性，类型为 Text。 指定事件列表内的字段的引用的类型。
ShowField	可选 文本。 ShowField 属性可设置为要显示的字段名称。 默认情况下，将显示来自外部列表中的记录的 Title 字段的超链接文本。 但可以使用 ShowField 属性替代该文本并显示外部列表中的另一个字段。 允许将下面的数据类型作为 ShowField 属性的目标：Text、Choice 和 Counter。
TextOnly	可选属性，类型为 Boolean。 指定仅包含文本值的字段。
类型	可选属性，类型为 Text。 指定适用于汇总列或计算列的函数。 可能的值包括： Avg 平均值。 适用于 DateTime数字、 整数和 货币 字段类型。 计数 项数。 适用于允许聚合的所有字段类型。 麦克斯 最大值。 适用于 DateTime数字、 整数和 货币 字段类型。 MIN 最小值。 适用于 DateTime数字、 整数和 货币 字段类型。 和 值的总和。 适用于“数字”、“整数”和“货币”字段类型。 STDEV 标准偏差。 适用于“数字”、“整数”和“货币”字段类型。 无 功 方差。 适用于“数字”、“整数”和“货币”字段类型。 Type 属性的值不区分大小写。

子元素

无

父元素

• BeginsWith
• Contains
• DateRangesOverlap
• 情 商
• FieldRefs
• Geq
• GroupBy
• 燃气轮机
• In
• 包括
• IsNotNull
• IsNull
• Leq
• Lt
• Neq
• NotIncludes
• OrderBy

出现次数

• 最小值：0
• 最大值：1 (在 OrderBy) 内无限制

示例

下面的示例查询在 Expires 字段为 null 或包含一个大于或等于当前日期的值的情况。

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

此示例来自要显示在工具栏中的联系人列表字段 的Schema.xml 文件中。

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>