ForEach-Element (Ansicht)

Artikel
10/16/2024

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

Bietet einen einfachen Mechanismus zum Auflisten einer Sammlung von Ansichten oder Feldern, die in der aktuellen Liste definiert sind.

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

Elemente und Attribute

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

Attribute

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

Untergeordnete Elemente

Zahlreich

Übergeordnete Elemente

Zahlreich

Vorkommen

Minimum: 0
Maximum: Unbegrenzt

Hinweise

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

CHOICES/CHOICE in einem Auswahlfeld . Beachten Sie Großschreibung und das Fehlen eines führenden Schrägstrichs (/). In diesem Fall muss das ForEach-Element in einem anderen ForEach-Element geschachtelt werden, das Fields/Field auflistet (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 (ähnlich wie Ansichten).
/LISTTEMPLATES/ListTemplate zum Aufzählen aller servergestützten Listendefinitionen, die in der Onet.xml-Datei angegeben sind (für Ankündigungen, Aufgaben, Kontakte, Ereignisse usw.).
/DOCUMENTTEMPLATES/DocumentTemplatezum Aufzählen aller vom Server unterstützten Dokumentbibliotheksvorlagendateien (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>

Freigeben über