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 要素内でのみサポートされます。フィールドがビュー定義内で明示的に宣言されている場合に TRUE となり、ビュー内部の Fields 列挙では返されません。
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>