ProjectedFields-Element (View)

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

Gibt die Felder in verknüpften Listen an, die in die Ansicht aufgenommen werden können, wenn eine oder mehrere andere Listen in einer Abfrage verknüpft wurden.

<ProjectedFields>
  <Field ... />
  <Field ... />
</ProjectedFields>

Elemente und Attribute

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

Attribute

Keine

Untergeordnete Elemente

• Field

Hinweis

Es gibt eine maximale Anzahl von untergeordneten Field-Elementen. Sie wird als Differenz zwischen der maximalen Anzahl zulässiger Felder in der Liste und der Anzahl der Felder definiert, die bereits in der Liste enthalten sind.

Übergeordnete Elemente

View

Vorkommen

• Minimum: 0
• Maximum: 1

Hinweis

Das View-Element kann nur dann über ein ProjectedFields-Element verfügen, wenn es über ein Joins-Element mit mindestens einem untergeordneten Join-Element verfügt. Ein ProjectedFields-Element , das den Wert einer SPQuery.ProjectedFields-Eigenschaft bildet und daher kein untergeordnetes Element eines View-Elements ist, kann jedoch verwendet werden, um eine implizite Verknüpfung ohne joins-Element zu unterstützen.

Es wird nicht empfohlen, ohne ein Joins-Element zu arbeiten. Sie maximieren die Chancen Ihrer Lösung, mit zukünftigen Versionen von Microsoft SharePoint Foundation kompatibel zu sein, indem Sie immer ein explizites Join-Element verwenden. Weitere Informationen zu impliziten Verknüpfungen mit ProjectedFields-Elementen finden Sie unter Listenjoins und Projektionen.

HinwBemerkungeneise

Wenn ein Feld aus einer verknüpften Liste nicht in ProjectedFields dargestellt wird, kann es nicht in das ViewFields-Element eingeschlossen werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie den Ergebnissen, die von der Abfrage zurückgegeben werden, ein weiteres Feld hinzufügen. Der Wert des List-Attributs ist ein Alias für die Fremdliste. Der Alias wird in einem Join-Element (Ansicht) definiert. Das ShowField-Attribut muss auf den internen Namen des Fremdfelds festgelegt werden.

Das Type-Attribut gibt nicht den Datentyp des Felds an, wie es normalerweise in einem Field-Element der Fall ist. Wenn ein Field-Element ein untergeordnetes Element eines ProjectedFields-Elements ist, gibt Type einfach an, ob das Join-Element (im Joins-Element , von dem das ProjectedFields-Element abhängt) auf einer vorhandenen Suchbeziehung zwischen den Listen basiert. Ab SharePoint Foundation 2010 müssen alle Verknüpfungen auf einer vorhandenen Nachschlagebeziehung basieren, sodass Type immer den Wert "Lookup" hat. Der tatsächliche Datentyp des Felds wird nicht angegeben, wenn es ein untergeordnetes Element des ProjectedFields-Elements ist. Der Datentyp des Felds spielt jedoch eine Rolle, da nur die folgenden Typen von Feldern in ein ProjectedFields-Element eingeschlossen werden können:

• Calculated (wie Nur-Text behandelt)
• ContentTypeId
• Leistungsindikator
• Währung
• DateTime
• Guid
• Ganzzahl
• Note (nur eine Zeile)
• Zahl
• Text

<ProjectedFields>
  <Field
    Name='CustomerCity'
    Type='Lookup'
    List='customerCities'
    ShowField='Title' />
</ProjectedFields>

Ein Beispiel für ein ProjectedFields-Element, dessen untergeordnetesField-Element über ein FieldRef-Attribut anstelle eines List-Attributs verfügt, finden Sie unter Listenjoins und Projektionen.