Получить строки коллекцией Result::fetchCollection
Модуль: main — подключать отдельно не нужно
Метод Result::fetchCollection читает все оставшиеся строки выборки и возвращает коллекцию объектов ORM, например EO_User_Collection. Коллекция нужна, чтобы обработать объекты пачкой. Например, получить списки значений методами get*List, изменить объекты и сохранить их одним вызовом save.
Сигнатура метода в классе Bitrix\Main\ORM\Query\Result:
final public function fetchCollection()
Возвращаемое значение
Метод возвращает коллекцию класса сущности. Если строк нет, коллекция пустая.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\SystemException |
Запрос группирует строки, например содержит group или агрегат вместе с обычными полями |
Bitrix\Main\SystemException |
В выборке нет первичного ключа, например select содержит только агрегаты |
Особенности
Метод вызывает fetchObject для каждой строки, поэтому для него действуют те же правила. Это первичный ключ в выборке, общий реестр объектов и приведение типов.
Примеры
Пример. Код читает языки коллекцией и получает список кодов:
<?php
use Bitrix\Main\Localization\LanguageTable;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$languages = LanguageTable::getList([
'select' => ['LID'],
'filter' => ['@LID' => ['en', 'ru']],
'order' => ['LID' => 'ASC'],
])->fetchCollection();
echo get_class($languages) . ' ' . implode(',', $languages->getLidList());
Код выведет Bitrix\Main\Localization\EO_Language_Collection en,ru.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая