SetList 元素 (视图)

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

指定当前正在使用的列表。

<SetList
  Name = "Text"
  PreserveContext = "TRUE" | "FALSE"
  Scope = "Request">
</SetList>

元素和属性

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

Attributes

属性	说明
名称	必需属性，类型为 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>

另请参阅

• List 元素 (List)