Elemento Where (Consulta)

Última modificación: viernes, 16 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

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

<Where>
</Where>

Atributos

Atributo	Descripción
Ninguno	N/D

Elementos secundarios

And, BeginsWith, Contains, DateRangesOverlap, Eq, Geq, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Membership, Neq, NotIncludes, Or

Elementos primarios

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 mezcla de operadores de comparación, operadores aritméticos simples, referencias de campo (columna), valores de constante y constantes Lenguaje de marcado de la aplicación de colaboración (CAML) predefinidas.

No es necesario que los campos a los que se hace referencia en un elemento Where sean campos de la lista primaria que se va a consultar. Si se va a unir una lista externa, los campos de ésta se pueden detallar en un elemento ProjectedFields y, a continuación, se puede hacer referencia a ellos 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>