Compartir a través de


Elemento ForEach (Vista)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Proporciona un mecanismo básico para enumerar una colección de vistas o campos definidos en la lista actual.

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

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
Select
Text obligatorio. El espacio de nombres que se va a enumerar.

Elementos secundarios

Numerosos

Elementos principales

Numerosos

Repeticiones

  • Mínimo: 0
  • Máximo: sin límite

Comentarios

El valor del atributo Select varía en los distintos archivos de esquema:

  • CHOICES/CHOICE dentro de un campo Elección . Tenga en cuenta la mayúscula y la falta de una barra diagonal inicial (/). En este caso, el elemento ForEach debe anidarse dentro de otro elemento ForEach que enumere Fields/Field (es decir, dentro de un elemento Fields ). El punto actual de la enumeración Fields debe ser un campo Choice .

  • /FIELDS/Field para enumerar todos los campos de la lista actual.

  • /FORMS/Form para enumerar todos los formularios de una lista determinada (muy similar a las vistas).

  • /LISTTEMPLATES/ListTemplate para enumerar todas las definiciones de lista admitidas por el servidor especificadas en el archivo Onet.xml (para anuncios, tareas, contactos, eventos, etc.).

  • /DOCUMENTTEMPLATES/DocumentTemplate para enumerar todos los archivos de plantilla de biblioteca de documentos compatibles con el servidor (hoja de cálculo de Microsoft Excel, documento de Microsoft Word, etc.).

El cuerpo del elemento ForEach se representa una vez para cada vista o campo en la colección. El elemento Property se puede usar para extraer propiedades individuales de la vista o campo.

El elemento ForEach también se puede usar para hacer referencia a un solo campo o vista. Para ello, debe establecerse una variable con el nombre del campo o la vista deseados; se usa el atributo MatchVar para hacer referencia a esa variable.

Ejemplo

El siguiente ejemplo usa el elemento ForEach para construir un cuadro de lista desplegable.

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