Описание
Метод статический: Возвращает значения свойств элементов инфоблока, соответствующих фильтру.
Поддерживает мультиязычность: при передаче параметра $LANGUAGE_ID
возвращает переведённые значения свойств на нужном языке.
Переопределяет базовый метод CIBlockElement::GetPropertyValues.
Сигнатура метода
CIBlockResult FCIBlockElement::GetPropertyValues( int $IBLOCK_ID, array $arElementFilter, bool $extMode = false, array $propertyFilter = [], string $LANGUAGE_ID = LANGUAGE_ID );
Параметры вызова
Параметр | Описание | С версии |
---|---|---|
IBLOCK_ID | Идентификатор инфоблока, к которому относятся элементы. | 1.0.0 |
arElementFilter | Фильтр для отбора элементов инфоблока (например, по ID, активности, дате). | 1.0.0 |
extMode | Режим вывода: если true , возвращаются расширенные данные свойств (включая описания, ID значений и т.д.). |
1.0.0 |
propertyFilter | Фильтр по свойствам. Позволяет ограничить выборку конкретными свойствами по их кодам или ID. | 1.0.0 |
LANGUAGE_ID | Код языка, для которого требуется вернуть переведённые значения свойств. Если не указан — используется текущий язык сайта. | 2.5.100 |
Возвращаемое значение
Метод возвращает объект CIBlockResult, содержащий значения пользовательских свойств элементов на нужном языке.
При extMode = true
структура будет включать подробную информацию по каждому значению.
Для получения результатов используйте GetNext()
или Fetch()
.
Пример
// Получаем свойства всех активных элементов на индонезийском языке $IBLOCK_ID = 10; $arElementFilter = ['ACTIVE' => 'Y']; $propertyFilter = ['MY_PROPERTY_CODE']; $LANG = 'id'; $res = FCIBlockElement::GetPropertyValues($IBLOCK_ID, $arElementFilter, true, $propertyFilter, $LANG); while ($arProps = $res->GetNext()) { print_r($arProps); }
Примечание: Метод используется при массовом получении свойств элементов для отображения витрины, экспорта или интеграции. Поддержка языка позволяет использовать его в мультиязычных интерфейсах без дополнительной постобработки данных.
Описание метода CIBlockElement::GetPropertyValues в официальной документации Битрикс
Количество показов: 526
Дата изменения: 23.06.2025 13:42:02