Elemento ForEach (Vista)

Última modificación: miércoles, 27 de enero de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

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

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

Atributos

Atributo

Descripción

Select

Text obligatorio. El espacio de nombres que se va a enumerar.

Elementos secundarios

Muchos

Elementos primarios

Muchos

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 un campo Choice.Tenga en cuenta las mayúsculas y minúsculas y la falta de una barra diagonal (/). En este caso, el elemento ForEach debe estar anidado dentro de otro elemento ForEach que enumera Fields/Field (en otras palabras, 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 para una lista particular (muy similar a las vistas).

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

  • /DOCUMENTTEMPLATES/DocumentTemplate para enumerar todos los archivos de plantillas de bibliotecas 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>