Value Element (Query)

Article
10/20/2016

Applies to: SharePoint Foundation 2010

Contains the value against which the value returned by the FieldRef element is compared.

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

Attributes

Attribute	Description
Type	Required Text. Specifies the data type for the value contained by this element.
IncludeTimeValue	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

ListProperty, Month, Now, Today, UserID, XML

Parent Elements

BeginsWith, Contains, DateRangesOverlap, Eq, Geq, Gt, Includes, IsNotNull, IsNull, Leq, Lt, Neq, NotIncludes, Values

Occurrences

Minimum: 0

Maximum: 1

Example

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. 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>