Элемент SetList (View)

Статья
04/08/2023

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Назначает текущий список.

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

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
Name	Обязательный атрибут типа Text. Указывает имя списка.
PreserveContext	Необязательный логический. Если используется значение FALSE, при реализации элемента SetList возвращается запрос к базе данных, необходимый для извлечения данных из формы, отображающей один элемент списка. Это полезно, когда представление и форма находятся на одной странице. Значение по умолчанию — TRUE.
Scope	Если задано значение Request, атрибут обеспечивает полную доступность списка для страницы.

Дочерние элементы

Нет

Родительские элементы

Метод

Occurrences

Минимум: 0
Максимум: 1

Замечания

При использовании элемента SetList необходимо применять внутреннее имя, которое не содержит пробелов и неизменяемо.

Элемент SetList имеет форму spanning и nonspanning, поэтому <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)

Поделиться через