Skip to Content

Получить элементы листа

Элемент считывает элементы списка SharePoint и сохраняет их в переменную типа DataTable: одна строка таблицы — один элемент списка, столбцы — поля. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

СвойствоТипОписание
Параметры:
Лист*ListСписок, полученный элементом Получить информацию о листе
ФильтрStringУсловие отбора элементов, например "fields/Status eq 'Новая'"
КолонкиList<String>Внутренние имена считываемых полей, например new List<string> { "Title", "Status" }. Если не заполнено — все поля
Результат:
РезультатDataTableПеременная для сохранения элементов
ЭлементыList<ListItem>Переменная для сохранения элементов в виде объектов. Используется в элементах Редактировать элемент листа и Удалить элемент листа. Необязательное свойство

Примечание: Имена столбцов результата — внутренние имена полей. Кроме полей списка результат содержит служебные столбцы: id — идентификатор элемента, Created, Modified и другие. См. Имена полей.

Примечание: Все значения возвращаются в виде строк. Даты — в формате ISO 8601 в UTC, например 2026-09-24T07:30:00Z.

Практический пример

Новые заявки

  • Лист: list
  • Фильтр: "fields/Status eq 'Новая'"
  • Колонки: new List<string> { "Title", "Status", "Amount" }
  • Результат: items

Значение поля первого элемента: items.Rows[0]["Title"].

Пример 2: изменение найденной записи

  1. Получить элементы листа: Лист — list, Фильтр — "fields/Title eq 'Заявка №125'", Элементы — spItems.
  2. Элемент выполнения кода: spItems[0].Fields.AdditionalData["Status"] = "Выполнена";
  3. Редактировать элемент листа: Элемент — spItems[0].

Возможные ошибки

ОшибкаПричина и решение
Не указан листНе заполнено свойство Лист
Field '...' cannot be referenced in filter or orderby as it is not indexedПоле из Фильтра не индексировано. Добавьте индекс в параметрах списка SharePoint
Last updated on