SPQuery.Joins-Eigenschaft
Ruft Sie Abschnitt der Abfrage, einschließlich aller untergeordneten Elemente hinzugefügt .
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Property Joins As String
Get
Set
'Usage
Dim instance As SPQuery
Dim value As String
value = instance.Joins
instance.Joins = value
public string Joins { get; set; }
Eigenschaftswert
Typ: System.String
Der Beitritt -Element XML.
Hinweise
Jede Verknüpfung wird durch ein untergeordnetes Element des Join des Joins -Elements dargestellt. Nur innere und linke äußere Verknüpfungen zulässig sind. Darüber hinaus muss das Feld in der Liste primäre ein Nachschlagefeld Typ sein, der auf das Feld in der Liste Fremdschlüssel sucht. Verknüpfungen mit mehreren Listen, mehrere Verknüpfungen dieselbe Liste und Ketten von Verknüpfungen können vorhanden sein. Wenn eine angegebene Liste der Liste Fremdschlüssel in mehr als eine Verknüpfung ist, muss es unterschiedliche Aliase durch die Attribute ListAliasJoin Elementen, die die Verknüpfungen zugewiesen haben.
Beispiele
Im folgenden Beispiel wird ein Joins-Element mit zwei linken äußeren Verknüpfungen gezeigt. CustomerName ist ein Nachschlagefeld in einer Orders-Liste. Damit wird das ID-Feld einer Customers-Liste nachgeschlagen. Die Customer-Liste wiederum enthält ein CityName-Feld, bei dem es sich um ein Nachschlagefeld für eine Cities-Liste handelt. Mit dem ersten Join-Element wird der Customers-Liste der Alias customers zugewiesen. Mit dem untergeordneten Eq-Element wird die Verknüpfung mit den Quell- und Zielfeldern der Nachschlagebeziehung definiert. Mit dem zweiten Join-Element wird der Cities-Liste der Alias customerCities zugewiesen. Damit wird die Verknüpfung parallel zur vorhandenen Nachschlagebeziehung zwischen den Listen Customer und Cities definiert.
Aliase sind für Listen wertvoll, da mehrere Verknüpfungen mit der gleichen Liste vorhanden sein können, die anhand von Aliasen unterschieden werden. Zusätzlich zu den Verknüpfungen zwischen Orders und Customer sowie zwischen Customer und Cities sind auch Verknüpfungen zwischen Orders und Suppliers sowie zwischen Suppliers und Cities möglich. Bei der letzten Verknüpfung würde der Cities-Liste ein anderer Alias (beispielsweise supplierCities) zugewiesen als der Verknüpfung zwischen Customer und Cities.
<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>