Elemento Joins (Vista)

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

Contiene los elementos Join necesarios para una consulta.

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

Elementos y atributos

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

Atributos

Ninguno

Elementos secundarios

• Join

Elementos principales

• Ver

Nota:

Cuando se usa un elemento Joins como parte de una consulta dinámica en lugar de como parte de la definición de una vista de lista; es decir, cuando es el valor de la propiedad SPQuery.Joins en lugar de la propiedad Joins , no tiene realmente un elemento primario.

Repeticiones

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

Ejemplo

A continuación se muestra un ejemplo de un elemento Joins con dos combinaciones externas izquierdas. CustomerName es un campo de búsqueda en una lista pedidos. Busca en el campo id. de una lista de clientes. La lista De clientes, a su vez, tiene un campo CityName que es un campo de búsqueda para una lista de ciudades.

El primer elemento Join asigna "customers" como alias para la lista Customers. El elemento secundario Eq define la combinación utilizando los mismos campos de origen y de destino que constituyen la relación de búsqueda. El segundo elemento Join asigna "customerCities" como alias a la lista Cities. Define la combinación en paralelo a la relación de búsqueda existente entre las listas Customer y Cities.

Los alias son necesarios para las listas debido a que puede haber más de una combinación para la misma lista y se necesitan alias distintos para diferenciar estas combinaciones. Por ejemplo, además de las combinaciones de pedidos a clientes y de clientes a ciudades, también puede haber combinaciones de pedidos a proveedores y de proveedores a ciudades. En el caso de la última combinación, se asignaría un alias diferente, por ejemplo, "supplierCities", a la lista Ciudades de la que se usa para la unión de cliente a ciudades.

<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>