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>