Elemento Joins (View)

  • Artículo

Última modificación: jueves, 19 de noviembre de 2009

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Contiene los elementos Join necesarios para una consulta.

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

Atributos

Atributo

Descripción

Ninguno

N/A

Elementos secundarios

Join

Elementos primarios

View

Nota

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

Repeticiones

Mínimo: 0

Máximo: 1

Ejemplo

El siguiente es un ejemplo de un elemento Joins con dos combinaciones externas izquierdas. CustomerName es un campo de búsqueda de una lista de pedidos que busca en el campo de identificación de una lista de clientes. La lista de clientes, a su vez, tiene un campo City que es un campo de búsqueda de una lista de ciudades. El primer elemento Join asigna ‘clientes’ como alias de la lista de clientes. El elemento Eq secundario define la combinación mediante los mismos campos de origen y de destino que constituyen la relación de búsqueda. El segundo elemento Join asigna ‘customerCities’ como alias de la lista de ciudades. Define la combinación en paralelo a la relación de búsqueda existente entre las listas de clientes y de ciudades.

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 distinto, por ejemplo ‘supplierCities’, a la lista de ciudades a partir del que se usa para la combinación de clientes 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>