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