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。合計列または集計列に適用する関数を指定します。以下のいずれかの値を使用できます。
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>