ForEach, élément (View)

Article
09/24/2014

Dernière modification : mercredi 27 janvier 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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>

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 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/Field pour énumérer tous les champs dans la liste en cours.
/FORMS/Form pour énumérer tous les formulaires pour une liste en particulier (très similaire aux vues).
/LISTTEMPLATES/ListTemplate pour énumérer toutes les définitions de liste prises en charge sur le serveur et spécifiées dans le fichier Onet.xml (pour les annonces, tâches, contacts, événements, etc.).
/DOCUMENTTEMPLATES/DocumentTemplate pour énumérer tous les fichiers de modèles des bibliothèques de documents pris en charge sur 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>

Partager via