Onde o elemento (Consulta)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Usado no contexto de uma consulta para especificar um filtro.

<Where>
</Where>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Nenhuma

Elementos filho

Elementos pai

Occurrences

Mínimo: 0
Máximo: 1

Comentários

A cláusula Where se traduz na instrução SELECT do SQL. O formato da cláusula Where é uma árvore XML estruturada com uma mistura de operadores de comparação, operadores aritméticos simples, referências de campo (coluna), valores constantes e constantes caml (linguagem de marcação de aplicativo colaborativa) predefinida.

Campos referenciados em um elemento Where não precisam ser campos da lista primária que está sendo consultada. Se uma lista estrangeira estiver sendo ingressada, campos da lista estrangeira poderão ser itemizados em um elemento ProjectedFields e, em seguida, poderão ser referenciados no elemento Where .

Exemplo

No exemplo a seguir, o elemento Where usa o elemento Geq como o filtro na consulta, retornando casos em que o valor de data e hora no campo Expira é maior que a data e a hora de hoje.

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

Partilhar via