Compartilhar via


Elemento Joins (Exibição)

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

Contém elementos de junção necessários para uma consulta.

<Joins>  <Join ... >  </Join>    <Join ... >  </Join>  ...</Joins>

Elementos e atributos

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

Atributos

Nenhuma

Elementos filho

Elementos pai

Observação

Quando um elemento Joins é usado como parte de uma consulta dinâmica em vez de como parte da definição de uma exibição de lista; ou seja, quando é o valor da propriedade SPQuery.Joins em vez da propriedade Joins , ela realmente não tem um elemento pai.

Occurrences

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

Exemplo

A seguir está um exemplo de um elemento Joins com duas junções externas à esquerda. CustomerName é um campo de pesquisa em uma lista de pedidos. Ele pesquisa o campo ID de uma lista de clientes. A lista de clientes, por sua vez, tem um campo CityName que é um campo de pesquisa para uma lista cidades.

O primeiro elemento Join atribui 'clientes' como um alias para a lista Clientes. O filho do elemento Eq define a junção usando os mesmos campos de origem e de destino que constituem a relação de pesquisa. O segundo elemento Join atribui 'customerCities' como um alias à lista Cidades. Ele define a junção em paralelo à relação de pesquisa existente entre as listas Cliente e Cidades.

Os aliases são necessários para as listas porque pode haver mais de uma junção à mesma lista e diferentes aliases são necessários para diferenciar as junções. Por exemplo, além das junções de Pedidos ao Cliente e de Cliente para Cidades, também pode haver junções de Pedidos a Fornecedores e de Fornecedores para Cidades. No caso da última junção, um alias diferente, por exemplo, "supplierCities", seria atribuído à lista Cidades da que é usada para a junção Cliente para Cidades.

<Joins>
  <Join Type='LEFT' ListAlias='customers'>
    <Eq>
      <FieldRef Name='CustomerName' RefType='Id' />
      <FieldRef List='customers' Name='ID' />
    </Eq>
  </Join>
  <Join Type='LEFT' ListAlias='customerCities'>
    <Eq>
      <FieldRef List='customer' Name='CityName' RefType='Id' />
      <FieldRef List='customerCities' Name='ID' />
    </Eq>
  </Join>
</Joins>