Elemento Where (Query)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Se usa en el contexto de una consulta para especificar un filtro.

<Where>
</Where>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno

Elementos secundarios

• And
• BeginsWith
• Contains
• DateRangesOverlap
• Eq
• Geq
• Gt
• En
• Incluye
• IsNotNull
• IsNull
• Leq
• Lt
• Membership
• Neq
• NotIncludes
• Or

Elementos principales

• Expr1
• Expr2
• Query

Repeticiones

• Mínimo: 0
• Máximo: 1

Comentarios

La cláusula Where se convierte en la instrucción SQL SELECT. El formato de la cláusula Where es un árbol XML estructurado con una combinación de operadores de comparación, operadores aritméticos simples, referencias de campo (columna), valores constantes y constantes predefinidas del lenguaje de marcado de aplicaciones de colaboración (CAML).

Los campos a los que se hace referencia en un elemento Where no tienen que ser campos de la lista principal que se está consultando. Si se está uniendo una lista externa, los campos de la lista externa se pueden detallar en un elemento ProjectedFields y, a continuación, se puede hacer referencia a ella en el elemento Where .

Ejemplo

En el ejemplo siguiente, el elemento Where usa el elemento Geq como filtro en la consulta; de este modo, se devuelven los casos donde el valor de fecha y hora del campo Expires es mayor que la fecha y hora actuales.

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