SetList 元素(视图)
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
本文内容
属性
子元素
父元素
出现次数
指定当前正在使用的列表。
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
属性
属性 |
说明 |
---|---|
Name |
必需属性,类型为 Text。指定该列表的名称。 |
PreserveContext |
可选属性,类型为 Boolean。如果为 FALSE,则实现 SetList 元素将返回数据库查询,该查询是获取显示单个列表项的表单中数据所必需的。当视图和表单位于同一页面中时,此功能非常有用。默认值为 TRUE。 |
Scope |
当设置为 Request 时,此属性使整个列表可用于该页面。 |
子元素
无 |
父元素
出现次数
最小值:0 最大值:1 |
备注
在使用 SetList 元素时,您需要使用不包含空格且固定的内部名称。
SetList 元素包含跨越表单和非跨越表单,因此 <SetList>Announcements</SetList> 与 <SetList Name="Announcements"/> 相同。
SetList 元素通常是用于批处理请求的 Method 元素的子级。
示例
如果当前列表等于所查找的列表,则下面的示例将从数据库中的"列表"表返回 Title 字段的值。最初,当前列表暂时分配给了变量 Old,然后恢复为当前列表。
<SetVar Scope="Request" Name="Old">
<List/>
</SetVar>
<SetList>
<GetVar Name="Lookup"/>
</SetList>
<IfEqual>
<Expr1>
<List/>
</Expr1>
<Expr2>
<GetVar Name="Lookup"/>
</Expr2>
<Then>
<ListProperty HTMLEncode="TRUE" Select="Title"/>
</Then>
</IfEqual>
<SetList><GetVar Name="Old"/></SetList>