FCIBlockSection::GetByID

Описание

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

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

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

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

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

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

Метод возвращает объект FCIBlockResult, содержащий данные раздела на выбранном языке. Если раздел с указанным ID не найден или неактивен, метод вернёт false. В случае ошибки текст будет доступен через свойство LAST_ERROR объекта.

Пример

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

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

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

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

Описание метода CIBlockSection::GetByID в официальной документации Битрикс

Количество показов: 438
Дата изменения: 23.06.2025 13:30:46