Elemento ForEach (Exibição)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Fornece um mecanismo básico para enumerar uma coleção de exibições ou campos definidos na lista atual.

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

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Select	Texto obrigatório. O namespace a ser enumerado.

Elementos filho

Numerosos

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

O valor do atributo Select varia nos diferentes arquivos de esquema:

CHOICES/CHOICE dentro de um campo Choice . Observe a capitalização e a falta de uma barra de frente (/). Nesse caso, o elemento ForEach deve ser aninhado dentro de outro elemento ForEach que enumera Campos/Campo (em outras palavras, dentro de um elemento Fields ). O ponto atual na enumeração Campos deve ser um campo Choice .
/FIELDS/Field para enumerar todos os campos da lista atual.
/FORMS/Form para enumerar todos os formulários para uma lista específica (muito semelhante a exibições).
/LISTTEMPLATES/ListTemplate para enumerar todas as definições de lista com suporte para servidor especificadas no arquivo Onet.xml (para anúncios, tarefas, contatos, eventos e assim por diante).
/DOCUMENTTEMPLATES/DocumentTemplate para enumerar todos os arquivos de modelo de biblioteca de documentos com suporte para servidor (planilha do Microsoft Excel, documento do Microsoft Word etc.).

O corpo do elemento ForEach é renderizado uma vez para cada exibição ou campo na coleção. O elemento Propriedade pode ser usado para extrair propriedades individuais do campo ou exibição.

O elemento ForEach também pode ser usado para fazer referência a um único campo ou exibição. Para fazer isso, uma variável deve ser definida com o nome do campo ou exibição desejado; o atributo MatchVar é usado para referenciar essa variável.

Exemplo

O exemplo a seguir usa o elemento ForEach para construir uma caixa de lista suspensa.

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

Compartilhar via