Where 要素 (クエリ)

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

クエリのコンテキスト内でフィルタを指定するために使用されます。

<Where>
</Where>

要素と属性

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

属性

なし

子要素

• And
• BeginsWith
• Contains
• DateRangesOverlap
• Eq
• Geq
• Gt
• インチ
• 含まれる内容
• IsNotNull
• IsNull
• Leq
• 中尉
• メンバーシップ
• Neq
• NotIncludes
• Or

親要素

• Expr1
• Expr2
• Query

Occurrences

• 最小 : 0
• 最大: 1

注釈

Where 句は、SQL SELECT ステートメントに変換されます。 Where 句の形式は、比較演算子、単純算術演算子、フィールド (列) 参照、定数値、および定義済みの Collaborative Application Markup Language (CAML) 定数を組み合わせて構成された XML ツリーです。

Where 要素で参照されるフィールドは、照会されているプライマリ リストのフィールドである必要はありません。 外部リストが結合されている場合は、外部リストのフィールドを ProjectedFields 要素で項目化し、 Where 要素で参照できます。

例

以下の例では、Where 要素は、クエリのフィルタとして Geq 要素を使用し、Expires フィールドの日付と時刻の値が、今日の日付と時刻より大きいケースを返します。

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