FCIBlockElement::GetPropertyValues

Описание

Метод статический: Возвращает значения свойств элементов инфоблока, соответствующих фильтру. Поддерживает мультиязычность: при передаче параметра $LANGUAGE_ID возвращает переведённые значения свойств на нужном языке. Переопределяет базовый метод CIBlockElement::GetPropertyValues.

Сигнатура метода

Code Copy code Code copied! 
1
2
3
4
5
6
7
8

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().

Пример

Code Copy code Code copied! 
1
2
3
4
5
6
7
8
9
10
11

// Получаем свойства всех активных элементов на индонезийском языке
$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 в официальной документации Битрикс

Количество показов: 769
Дата изменения: 23.06.2025 13:42:02