Описание
Метод статический: Предназначен для выборки только опубликованных элементов информационного блока.
Поддерживает мультиязычность: при указании параметра LANGUAGE_ID
возвращаются данные элемента на соответствующем языке.
Возвращается объект FCIBlockResult с полями элемента информационного блока.
Переопределяет базовый метод CIBlockElement::GetByID и расширяет его функциональность в рамках мультиязычного подхода.
Сигнатура метода
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
объекта.
Пример
// Идентификатор элемента, для которого нужно получить перевод $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