SPQuery.Joins property
Obtém ou define a seção de elemento junções da consulta incluindo todos os seus elementos-filho.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
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; }
Property value
Type: System.String
Elemento ingressa em XML.
Comentários
Cada associação é representada por um filho do elemento de associação do elemento de associações . Junções externas somente internas e esquerdas são permitidas. Além disso, o campo na lista principal deve ser um campo de tipo de pesquisa que procure por para o campo da lista externa. Pode haver associações em várias listas, associações múltiplas para a mesma lista e cadeias de associações. Se uma determinada lista é a lista externa em mais de uma associação, ele deve ter aliases distintos atribuídos a ele pelos atributos ListAlias dos elementos de associação que representa as associações.
Examples
A seguir está um exemplo de um elemento de associações com duas associações externas à esquerda. CustomerName é um campo de pesquisa em uma lista de ordens. Ele procura ao campo Identificação de uma lista de clientes. Lista de clientes, por sua vez, tem um campo de nome de cidade é um campo de pesquisa a uma lista de cidades. O primeiro elemento de associação atribui 'clientes' como um alias para a lista de clientes. O filho do elemento Eq define a associação usando a mesma fonte e campos de destino que constituem a relação de pesquisa. O segundo elemento de associação atribui 'customerCities' como um alias para a lista de cidades. Ele define a associação em paralelo para a relação de pesquisa existente entre as listas de cliente e de cidades.
Aliases são valiosos para as listas porque pode haver mais de uma associação para a mesma lista e aliases diferentes são necessárias para diferenciar as associações. Por exemplo, além das associações de pedidos de cliente e de cliente para cidades, pode também haver associações de pedidos a fornecedores e de fornecedores para cidades. No caso da última associação, outro alias, dizer 'supplierCities', seria atribuído à lista de cidades de uma que é usado para o cliente a junção de 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=’customers’ Name=’CityName’ RefType=’Id’ />
<FieldRef List=’customerCities’ Name=’ID’ />
</Eq>
</Join>
</Joins>