de la propiedad SPQuery.Joins
Obtiene o establece la sección de elemento se une a de la consulta incluyendo todos sus elementos secundarios.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Property Joins As String
Get
Set
'Uso
Dim instance As SPQuery
Dim value As String
value = instance.Joins
instance.Joins = value
public string Joins { get; set; }
Valor de propiedad
Tipo: System.String
El elemento se une a XML.
Comentarios
Cada combinación está representada por un elemento secundario de combinación del elemento de combinaciones . Se permiten combinaciones externas sólo internas e izquierdas. Además, el campo en la lista principal debe ser un campo de tipo de búsqueda que busca en el campo en la lista externa. Puede haber varias combinaciones a la misma lista y cadenas de combinaciones, de combinaciones a varias listas. Si una lista determinada es la lista externa en más de una combinación, debe tener asignados por los atributos de ListAlias de los elementos de la combinación que representa las combinaciones de alias distintos.
Ejemplos
El siguiente es un ejemplo de un elemento de combinaciones con dos combinaciones externas izquierdas. CustomerName es un campo de búsqueda en una lista de pedidos. Busca en el campo de identificador de una lista de los clientes. La lista de clientes, a su vez, tiene un campo de ciudad que es un campo de búsqueda a una lista de ciudades. El primer elemento Join asigna a 'clientes' como un alias para la lista de los clientes. Elemento secundario del elemento Eq define la combinación con el mismo origen y campos de destino que constituyen a la relación de búsqueda. El segundo elemento Join asigna 'customerCities' como un alias a la lista de ciudades. Define la participación en paralelo a la relación de búsqueda existente entre las listas de cliente y ciudades.
Los alias son importantes 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 ‘ciudadesDeProveedores’, 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=’customers’ Name=’CityName’ RefType=’Id’ />
<FieldRef List=’customerCities’ Name=’ID’ />
</Eq>
</Join>
</Joins>