Élément ForEach (View)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | 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à l’intérieur d’un champ Choice. 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/Fieldpour énumérer tous les champs de la liste actuelle./FORMS/Formpour énumérer tous les formulaires d’une liste particulière (très similaire aux affichages)./LISTTEMPLATES/ListTemplatepour énumérer toutes les définitions de listes serveur pris en charge spécifiées dans le fichier Onet.xml (pour les annonces, les tâches, les contacts, les événements, et ainsi de suite)./DOCUMENTTEMPLATES/DocumentTemplatepour l’éumation de tous les fichiers de modèles de bibliothèque de documents pris en charge par le serveur (feuille de Microsoft Excel, Microsoft Word document, 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>