Freigeben über

Join-Element (View)

  • Artikel

Letzte Änderung: Freitag, 25. Dezember 2009

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Wird zum Verknüpfen von zwei Listen für Abfragen verwendet.

<Join   Type= "LEFT" | "INNER"  ListAlias= "TEXT"></Join>

Attribute

Attribut

Beschreibung

Typ

Erforderlich. LEFT steht für eine linke äußere Verknüpfung. INNER steht für eine innere Verknüpfung.

ListAlias

Optional. Gibt einen alternativen Namen für die fremde Liste an. Dies kann hilfreich sein, wenn zwei Verknüpfungen mit der gleichen Liste vorhanden sind. Zum Unterscheiden der Verknüpfungen werden unterschiedliche Aliase verwendet.

Der Alias muss nicht explizit dem tatsächlichen Namen der fremden Liste zugeordnet werden, da Verknüpfungen nur über eine Nachschlagefeldbeziehung zulässig sind und die fremde Liste in der Definition des Nachschlagefelds angegeben wird.

Wenn dieser Wert in einem Join-Element definiert wurde, wird der Wert an zwei Stellen für ein List-Attribut verwendet:

  • In einem FieldRef-Element, das dem Eq-Element des Join-Elements untergeordnet ist.

  • In einem Field-Element, das einem ProjectedFields-Element untergeordnet ist.

Untergeordnete Elemente

Eq

Übergeordnete Elemente

Joins

Vorkommen

Minimum: 1

Maximum: Der Wert der MaxQueryLookupFields-Eigenschaft für das SPWebApplication-Objekt, das die abzufragende primäre Liste enthält. Der Systemstandardwert ist 8.

Hinweise

Das Join-Element wird in die SQL JOIN-Anweisung übersetzt. Mit dem Join-Element wird das Eq-Element umgestaltet, um die primären und fremden Felder anzugeben, in denen die Verknüpfung hergestellt werden soll. Das primäre Feld muss als Nachschlagefeld für das fremde Feld definiert sein.

Beispiel

Im folgenden Beispiel werden zwei Join-Elemente gezeigt; beide sind linke äußere Verknüpfungen. 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>