ProjectedFields-Element (Ansicht)

Letzte Änderung: Freitag, 15. Oktober 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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>

Attribute

Keine

Untergeordnete Elemente

Field

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

Übergeordnete Elemente

View

Vorkommen

Hinweis

Das View-Element kann kein ProjectedFields-Element enthalten, wenn es kein Joins-Element mit mindestens einem untergeordneten Join-Element aufweist. Allerdings kann ein ProjectedFields-Element, das den Wert einer SPQuery.ProjectedFields-Eigenschaft bildet und daher kein untergeordnetes Element eines View-Elements ist, zur Unterstützung einer impliziten Verknüpfung ohne ein Joins-Element verwendet werden. Die Verwendung von Verknüpfungen ohne Joins-Element wird jedoch nicht empfohlen. Sie maximieren die Wahrscheinlichkeit, dass Ihre Lösung mit zukünftigen Versionen von Microsoft SharePoint Foundation kompatibel ist, wenn Sie immer ein explizites Join-Element verwenden. Weitere Informationen zu impliziten Verknüpfungen mit ProjectedFields-Elementen finden Sie unter Listenverknüpfungen und Projektionen.

Mindestvorkommen: 0 Maximum: 1

Hinweise

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

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie den von der Abfrage zurückgegebenen Werten ein weiteres Feld hinzugefügt wird. Der Wert des List-Attributs ist ein Alias für die Fremdliste. Der Alias ist in einem Join-Element (View) definiert. Das ShowField-Attribut muss auf den internen Namen des Fremdfelds festgelegt werden.

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

• Calculated (wie Nur-Text behandelt)

• ContentTypeId

• Counter

• Currency

• DateTime

• Guid

• Integer

• Note (nur eine Zeile)

• Number

• Text

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

Ein Beispiel für ein ProjectedFields-Element, dessen untergeordnetes Field-Element ein FieldRef-Attribut anstelle eines List-Attributs aufweist, finden Sie unter Listenverknüpfungen und Projektionen.