FieldRef 元素（查询）

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

适用范围： SharePoint Foundation 2010

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

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

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

属性

属性	说明
Alias	可选属性，类型为 Text。
Ascending	可选属性，类型为 Boolean。指定有关视图中定义的 FieldRef 元素的排序顺序。默认值为 TRUE。
CreateURL	可选属性，类型为 Text。指定用于创建会议工作区网站的 .aspx 文件的 URL。
DisplayName	可选属性，类型为 Text。此属性提供将引用的字段的显示名称。
Explicit	可选属性，类型为 Boolean。仅在 ViewFields 元素中支持此属性。如果在视图定义中显式声明此字段，并且此字段在视图内的 Fields 枚举中未返回，则为 TRUE。
Format	可选属性，类型为 Text。
ID	可选属性，类型为 Text。指定标识字段的 GUID。
Key	可选属性，类型为 Text。如果设置为 Primary，则指定该字段为其表的主键，因此将唯一标识表中的每条记录。
List	可选属性，类型为 Text。FieldRef 元素是 Join 元素中 Eq 元素的子项时，指定父外部列表。值是 Join 元素的 ListAlias 属性定义的列表别名。
Name	可选属性，类型为 Text。此属性提供将引用的字段的内部名称。
RefType	可选属性，类型为 Text。指定事件列表内的字段的引用的类型。
ShowField	可选属性，类型为 Text。ShowField 属性可设置为要显示的字段名称。默认情况下，将显示来自外部列表中的记录的 Title 字段的超链接文本。但可以使用 ShowField 属性重写该值，并显示来自外部列表中的另一个字段。 允许将下面的数据类型用作 ShowField 属性的目标：Text、Choice 和 Counter。
TextOnly	可选属性，类型为 Boolean。指定仅包含文本值的字段。
Type	可选属性，类型为 Text。指定适用于汇总列或计算列的函数。可能的值包括： AVG   平均值。适用于 DateTimeNumber、Integer 和 Currency 字段类型。 COUNT   项数。适用于允许聚合的所有字段类型。 MAX   最大值。适用于 DateTimeNumber、Integer 和 Currency 字段类型。 MIN   最小值。适用于 DateTimeNumber、Integer 和 Currency 字段类型。 SUM   值总和。适用于 Number、Integer 和 Currency 字段类型。 STDEV   标准偏差。适用于 Number、Integer 和 Currency 字段类型。 VAR   方差。适用于 Number、Integer 和 Currency 字段类型。 Type 属性的值不区分大小写。

子元素

无

父元素

BeginsWith、Contains、DateRangesOverlap、Eq、FieldRefs、Geq、GroupBy、Gt、In、Includes、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>