Élément ForEach (View)

  • Article

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Fournit un mécanisme de base pour énumérer une collection de vues ou de champs définie dans la liste en cours.

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

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
Select
Obligatoire Text. Espace de noms à énumérer.

Éléments enfants

Nombreux

Éléments parents

Nombreux

Occurrences

  • Minimum : 0
  • Maximum : pas de limite

Remarques

La valeur de l'attribut Select varie dans les différents fichiers de schéma :

  • CHOICES/CHOICE dans un champ Choix . Notez la mise en majuscules et l'absence de barre oblique (/) au début. Dans ce cas, l'élément ForEach doit être imbriqué à l'intérieur d'un autre élément ForEach qui énumère le ou les champs (en d'autres termes, dans un élément Fields). Le point actuel dans l'énumération Fields doit être un champ Choice.

  • /FIELDS/Field pour énumérer tous les champs de la liste active.

  • /FORMS/Form pour énumérer tous les formulaires d’une liste particulière (très similaire aux vues).

  • /LISTTEMPLATES/ListTemplate pour énumérer toutes les définitions de liste prises en charge par le serveur spécifiées dans le fichier Onet.xml (pour les annonces, les tâches, les contacts, les événements, etc.).

  • /DOCUMENTTEMPLATES/DocumentTemplate pour énumérer tous les fichiers modèles de bibliothèque de documents pris en charge par le serveur (feuille de calcul Microsoft Excel, document Microsoft Word, etc.).

Le corps de l'élément ForEach est rendu une seule fois pour chaque vue ou champ dans la collection. L'élément Property peut être utilisé pour extraire des propriétés de la vue ou du champ.

L'élément ForEach peut également être utilisé pour référencer un seul champ ou vue. Pour ce faire, vous devez définir une variable avec le nom du champ ou de la vue souhaitée ; l'attribut MatchVar est utilisé pour référencer cette variable.

Exemple

Le code exemple suivant utilise l'élément ForEach pour créer une zone de liste déroulante.

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