Joins-Element (View)

Letzte Änderung: Donnerstag, 19. November 2009

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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

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

Attribute

Attribut	Beschreibung
Keine	N/V

Untergeordnete Elemente

Join

Übergeordnete Elemente

View

Hinweis
Wenn ein Joins-Element als Teil einer dynamischen Abfrage anstatt als Teil der Definition einer Listenansicht verwendet wird, das heißt, wenn das Element der Wert der SPQuery.Joins-Eigenschaft und nicht der Joins-Eigenschaft ist, hat das Element im Grunde kein übergeordnetes Element.

Vorkommen

Minimum: 0 Maximum: 1

Beispiel

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 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. 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=’customer’ Name=’CityName’ RefType=’Id’ />
      <FieldRef List=’customerCities’ Name=’ID’ />
    </Eq>
  </Join>
</Joins>