ある要素 (クエリ)Where element (Query)

に適用されます: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint オンライン |SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

クエリのコンテキスト内でフィルタを指定するために使用されます。Used within the context of a query to specify a filter.

<Where>
</Where>

要素と属性Elements and attributes

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

なしNone

子要素Child elements

親要素Parent elements

出現回数Occurrences

  • 最小 : 0Minimum: 0
  • 最大: 1Maximum: 1

解説Remarks

選択して[SQL ステートメントのWhere句に変換します。The Where clause translates into the SQL SELECT statement. Where句の形式は、比較演算子、単純な算術演算子、フィールド (列) への参照、定数値、および共同作業アプリケーション マークアップ言語 (CAML) の定義済みの定数の組み合わせで構造化された XML ツリーです。The format of the Where clause is a structured XML tree with a mixture of comparison operators, simple arithmetic operators, field (column) references, constant values, and predefined Collaborative Application Markup Language (CAML) constants.

場所要素で参照されているフィールドはクエリは、対象となるプライマリ リストのフィールドではありません。Fields referenced in a Where element do not have to be fields of the primary list that is being queried. 外部リストを結合するが、外部リストからフィールドはProjectedFields要素を明細化することができ、位置の要素で参照できます。If a foreign list is being joined, fields from the foreign list can be itemized in a ProjectedFields element and can then be referenced in the Where element.

Example

次の例では、位置の要素は、[期限] フィールドに日付と時刻の値が今日の日付と時刻より大きい値を返す、クエリのフィルターとしてGeq要素を使用します。In the following example, the Where element uses the Geq element as the filter in the query, returning cases where the date and time value in the Expires field is greater than today's date and time.

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