FCIBlockElement::GetByID

Описание

Метод статический: Предназначен для выборки только опубликованных элементов информационного блока. Поддерживает мультиязычность: при указании параметра LANGUAGE_ID возвращаются данные элемента на соответствующем языке. Возвращается объект FCIBlockResult с полями элемента информационного блока. Переопределяет базовый метод CIBlockElement::GetByID и расширяет его функциональность в рамках мультиязычного подхода.

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

Code Copy code Code copied!
1
2
3
4
5
FCIBlockResult
FCIBlockElement::GetByID(
 int $ID,
 string $LANGUAGE_ID = LANGUAGE_ID
);

Параметры вызова

Параметр Описание С версии
ID Идентификатор элемента информационного блока. 1.0.0
LANGUAGE_ID Код языка, например, 'en', 'de', 'id'. Позволяет получить данные на определённом языке вне зависимости от текущего языка сайта. Если параметр не указан — используется язык текущего сайта из глобальной константы LANGUAGE_ID. 2.5.100

Возвращаемое значение

Метод возвращает объект FCIBlockResult, содержащий данные элемента информационного блока на запрошенном языке. В случае ошибки возвращается false. Для получения текста ошибки используйте свойство LAST_ERROR объекта.

Пример

Code Copy code Code copied!
1
2
3
4
5
6
7
8
9
10
11
12
// Идентификатор элемента, для которого нужно получить перевод
$ID = 123;
$LANG = 'en'; // Язык, на котором нужно получить данные

// Получаем элемент на нужном языке
$res = FCIBlockElement::GetByID($ID, $LANG);

if ($arItem = $res->GetNext()) {
    echo "Название: " . $arItem["NAME"];
} else {
    echo "Элемент не найден.";
}

Примечание: Метод не проверяет, чтобы элемент с указанным ID был опубликован или не являлся записью из истории. Для получения актуальной информации рекомендуется дополнительно проверять статус активности элемента.

Подробное описание метода в официальной документации

Количество показов: 531
Дата изменения: 23.06.2025 13:36:20