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>