Элемент ForEach (View)

Статья
04/08/2023

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

Предоставляет общий механизм перечисления коллекции представлений или полей, заданных в текущем списке.

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

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

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

Атрибуты

Атрибут	Описание
Select	Обязательный атрибут типа Text. Перечисляемое пространство имен.

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

Многочисленные

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

Многочисленные

Occurrences

Минимум: 0
Максимум: без ограничений

Замечания

Значение атрибута Select различается в разных файлах схем:

CHOICES/CHOICE внутри поля Выбор . Обратите внимание на заглавные буквы и отсутствие открывающей косой черты (/). В этом случае элемент ForEach должен вставляться внутрь другого элемента ForEach, перечисляющего Fields/Field (другими словами, внутри элемента 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>

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