Value element (Query)

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

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

  Type = "Text"
  IncludeTimeValue = "TRUE" | "FALSE">

Elements and attributes

The following sections describe attributes, child elements, and parent elements.


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


  • Minimum: 0
  • Maximum: 1


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.

        <FieldRef Name="BaseType" />
        <Value Type="Integer">1</Value>
        <FieldRef Name="Project" />
        <Value Type="Integer">
          <ProjectProperty Select="ID" />
    <FieldRef Name="Title" />
    <FieldRef Name="ID" />