ForEach-Element (Ansicht)

Artikel
09/24/2014

Letzte Änderung: Mittwoch, 27. Januar 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Bietet einen grundlegenden Mechanismus, um eine Auflistung von Ansichten oder Feldern aufzuzählen, die in der aktuellen Liste definiert sind.

<ForEach
  Select = "Text">
</ForEach>

Attribute

Attribut	Beschreibung
Select	Erforderlicher Text-Wert. Der aufzuzählende Namespace.

Untergeordnete Elemente

Zahlreiche

Übergeordnete Elemente

Zahlreiche

Vorkommen

Minimum: 0

Maximum: Unbegrenzt

Hinweise

Der Wert des Select-Attributs variiert in den verschiedenen Schemadateien:

CHOICES/CHOICE innerhalb eines Choice-Felds. Beachten Sie die Großschreibung und das Fehlen des Schrägstrichs (/). In diesem Fall muss das ForEach-Element innerhalb eines anderen ForEach-Elements geschachtelt werden, das Fields/Field aufzählt (d. h. innerhalb eines Fields-Elements). Der aktuelle Punkt in der Fields-Enumeration muss ein Choice-Feld sein.
/FIELDS/Field zum Aufzählen aller Felder in der aktuellen Liste.
/FORMS/Form zum Aufzählen aller Formulare für eine bestimmte Liste (sehr ähnlich zu Ansichten).
/LISTTEMPLATES/ListTemplate zum Aufzählen aller serverunterstützten Listendefinitionen, die in der Datei Onet.xml (für Ankündigungen, Aufgaben, Kontakte, Ereignisse usw.) angegeben sind.
/DOCUMENTTEMPLATES/DocumentTemplate zum Aufzählen aller serverunterstützten Dokumentbibliotheksvorlagen-Dateien (Microsoft Excel-Arbeitsblatt, Microsoft Word-Dokument usw.).

Der Inhalt des ForEach-Elements wird einmal pro Ansicht oder Feld in der Auflistung gerendert. Mit dem Property-Element können einzelne Eigenschaften der Ansicht oder des Felds extrahiert werden.

Das ForEach-Element kann auch verwendet werden, um auf ein einzelnes Feld oder eine einzelne Ansicht zu verweisen. Hierfür muss eine Variable auf den Namen des gewünschten Felds oder der Ansicht festgelegt werden; mit dem MatchVar-Attribut wird auf diese Variable verwiesen.

Beispiel

Im folgenden Beispiel wird das ForEach-Element verwendet, um ein Dropdown-Listenfeld zu erstellen.

<ForEach Select="CHOICES/CHOICE">
   <HTML>fld.AddChoice(</HTML>
   <ScriptQuote>
      <Property Select="."/>
   </ScriptQuote>
   <HTML>, </HTML>
   <ScriptQuote>
      <Property Select="Value"/>
   </ScriptQuote>
   <HTML>);</HTML>
</ForEach>

Share via