Joins-Element (View)

Artikel
04/08/2023

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Enthält Join-Elemente, die für eine Abfrage benötigt werden.

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

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Keine

Untergeordnete Elemente

Join

Übergeordnete Elemente

View

Hinweis

Wenn ein Joins-Element als Teil einer dynamischen Abfrage anstelle von als Teil der Definition einer Listenansicht verwendet wird; Das heißt, wenn es sich um den Wert der SPQuery.Joins-Eigenschaft und nicht um die Joins-Eigenschaft handelt, verfügt sie nicht wirklich über ein übergeordnetes Element.

Vorkommen

Minimum: 0
Maximum: 1

Beispiel

Es folgt ein Beispiel für ein Joins-Element mit zwei linken äußeren Verknüpfungen. CustomerName ist ein Nachschlagefeld in einer Liste "Bestellungen". Es wird bis zum ID-Feld einer Kundenliste nachschlagen. Die Kundenliste verfügt wiederum über ein Feld "CityName", bei dem es sich um ein Nachschlagefeld für eine Städteliste handelt.

Das erste Join-Element weist "customers" als Alias für die Kundenliste zu. Das untergeordnete Eq-Element definiert den Join mithilfe der gleichen Quell- und Zielfelder, die die Nachschlagebeziehung bilden. Das zweite Join-Element weist der Liste Cities "customerCities" als Alias zu. Der Join wird parallel zur vorhandenen Suchbeziehung zwischen den Listen Kunde und Städte definiert.

Aliase werden für die Listen benötigt, 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. Im Fall des letzten Joins wird der Liste Städte ein anderer Alias zugewiesen, z. B. "supplierCities", als für den Beitritt zwischen Kunden und Städten verwendet wird.

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

Freigeben über