Описание
Метод статический: Предназначен для выборки только опубликованных элементов информационного блока.
Поддерживает мультиязычность: при указании параметра 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 был опубликован или не являлся записью из истории.
Для получения актуальной информации рекомендуется дополнительно проверять статус активности элемента.
Подробное описание метода в официальной документации
Количество показов: 814
Дата изменения: 23.06.2025 13:36:20