通过

ForEach 元素 (视图)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

提供一个用于枚举当前列表中定义的视图或字段的集合的基本机制。

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

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
Select
必需属性，类型为 Text。 要枚举的命名空间。

子元素

众多

父元素

众多

出现次数

  • 最小值：0
  • 最大值：无限制

备注

Select 属性的值在不同的架构文件中有所不同：

  • CHOICES/CHOICE 在 “选择” 字段中。 注意区分大小写以及是否缺少前导左斜线 (/)。 在这种情况下，ForEach 元素必须嵌套在另一个枚举 Fields/Field 的 ForEach 元素（即 Fields 元素）之内。 Fields 枚举中的当前点必须是 Choice 字段。

  • /FIELDS/Field ，用于枚举当前列表中的所有字段。

  • /FORMS/Form 枚举特定列表的所有窗体 (与视图) 非常相似。

  • /LISTTEMPLATES/ListTemplate ，用于枚举 Onet.xml 文件中指定的所有服务器支持的列表定义， (公告、任务、联系人、事件等) 。

  • /DOCUMENTTEMPLATES/DocumentTemplate 用于枚举所有服务器支持的文档库模板文件 (Microsoft Excel 工作表、Microsoft Word 文档等) 。

ForEach 元素的主体针对集合中的每个视图或字段呈现一次。 Property 元素可用于提取视图或字段的各个属性。

ForEach 元素还可以用于引用单个字段或视图。 为此，必须使用所需字段或视图的名称设置变量；MatchVar 属性用于引用该变量。

示例

下面的示例使用 ForEach 元素构造一个下拉列表框。

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