FieldRef 要素 (Query)

適用対象: 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>

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性	説明
Alias	オプションの Text。
昇順	省略可能 なブール値。 ビューで定義されている FieldRef 要素の並べ替え順序を指定します。 既定値は TRUE です。
CreateURL	オプションの Text。 会議ワークスペース サイトを作成するために使用する .aspx ファイルの URL を指定します。
DisplayName	オプションの Text。 この属性は、参照されるフィールドの表示名を指定します。
Explicit	省略可能 なブール値。 この属性は、ViewFields 要素内でのみサポートされます。 フィールドがビュー定義内で明示的に宣言されている場合に TRUE となり、ビュー内部の Fields 列挙では返されません。
Format	オプションの Text。
ID	オプションの Text。 フィールドを識別する GUID を指定します。
Key	オプションの Text。 Primary に設定されている場合は、フィールドがテーブルの主キーであり、テーブル内の各レコードを一意に識別することを示します。
List	オプションの Text。 FieldRef 要素が Join 要素の Eq 要素の子の場合に、親外部リストを指定します。 値は、Join 要素の ListAlias 属性によって定義されているリストの別名です。
Lookupid	省略可能 なブール値。 フィールドがルックアップ型の場合は、クエリがフィールド値ではなく一意の項目 ID で項目を検索することを指定します。 これは、たとえば、フィールドに同じ値を持つ複数の項目があり、特定の項目に対してクエリを実行する場合に便利です。 既定値は false です。
名前	オプションの Text。 この属性は、参照されるフィールドの内部名を指定します。
RefType	オプションの Text。 イベント リスト内のフィールドの参照の種類を指定します。
ShowField	オプションの Text。 ShowField 属性を設定することにより、フィールド名を表示できます。 既定では、外部リスト内に含まれるレコードの Title フィールドのハイパーリンク テキストが表示されます。 ただし、ShowField 属性を使用してこの動作を無効にし、外部リストの別のフィールドを表示できます。 ShowField 属性のターゲットとして使用できるデータ型は、Text、Choice、および Counter です。
TextOnly	省略可能 なブール値。 フィールドにテキスト値のみが含まれることを指定します。
Type	オプションの Text。 合計列または集計列に適用する関数を指定します。 以下のいずれかの値を使用できます。 平均 平均値。 DateTime数値、整数、および通貨の各フィールド型に適用されます。 カウント 項目の数。 集計を許可するすべてのフィールド型に適用されます。 最大 最大値。 DateTime数値、整数、および通貨の各フィールド型に適用されます。 分 最小値。 DateTime数値、整数、および通貨の各フィールド型に適用されます。 合計 値の合計。 数値、整数、および通貨の各フィールド型に適用されます。 標準偏差 標準偏差。 数値、整数、および通貨の各フィールド型に適用されます。 Var 分散。 数値、整数、および通貨の各フィールド型に適用されます。 Type 属性の値は、大文字と小文字が区別されません。

子要素

None

親要素

• BeginsWith
• Contains
• DateRangesOverlap
• Eq
• FieldRefs
• Geq
• GroupBy
• Gt
• In
• 含まれる内容
• IsNotNull
• IsNull
• Leq
• 中尉
• Neq
• NotIncludes
• OrderBy

Occurrences

• 最小 : 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>