値要素 (クエリ)Value element (Query)

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

FieldRef 要素で返される値の比較対象の値を格納します。Contains the value against which the value returned by the FieldRef element is compared.

<Value
  Type = "Text"
  IncludeTimeValue = "TRUE" | "FALSE>
</Value>

要素と属性Elements and attributes

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

属性Attributes

属性Attribute 説明Description
Type
必須の Text。この要素が格納する値のデータ型を指定します。Required Text. Specifies the data type for the value contained by this element.
IncludeTimeValueIncludeTimeValue
オプションの Boolean。時刻と日付に基づいて、DateTime クエリを作成するように指定します。この属性を設定しない場合、日付と時刻に関連するクエリの時刻部分は無視されます。Optional Boolean. Specifies to build DateTime queries based on time as well as date. If you do not set this attribute, the time portion of queries that involve date and time are ignored.

子要素Child elements

親要素Parent elements

出現回数Occurrences

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

Example

次の例では、クエリは、 BaseTypeのフィールドが 1 と等しい、プロジェクトのフィールドが現在のプロジェクト プロパティの ID と同じである場合を返します。In the following example, the query returns cases where the BaseType field equals 1, and the Project field equals the ID of the current project property. 結果は昇順で返される、最初のタイトル、ID でResults are returned in ascending order, first by Title and then by ID.

<Query>
  <Where>
    <And>
      <Eq>
        <FieldRef Name="BaseType" />
        <Value Type="Integer">1</Value>
      </Eq>
      <Eq>
        <FieldRef Name="Project" />
        <Value Type="Integer">
          <ProjectProperty Select="ID" />
        </Value>
      </Eq>
    </And>
  </Where>
  <OrderBy>
    <FieldRef Name="Title" />
    <FieldRef Name="ID" />
  </OrderBy>
</Query>