ForEach 元素（视图）

  • 项目

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

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

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

属性

属性

说明

Select

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

子元素

很多

父元素

很多

出现次数

最小值：0

最大值：无限制

备注

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

  • CHOICES/CHOICE，位于 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>