Описание
Метод статический: Предназначен для получения данных раздела информационного блока по его идентификатору.
Поддерживает мультиязычность: при указании параметра LANGUAGE_ID возвращаются поля раздела на соответствующем языке, если перевод существует.
Переопределяет базовый метод CIBlockSection::GetByID и расширяет его функциональность в рамках мультиязычного подхода.
Сигнатура метода
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 объекта.
Пример
// Идентификатор раздела, для которого нужно получить перевод
$ID = 42;
$LANG = 'id'; // Например, индонезийский язык
// Получаем раздел на нужном языке
$res = FCIBlockSection::GetByID($ID, $LANG);
if ($arSection = $res->GetNext()) {
echo "Название раздела: " . $arSection["NAME"];
} else {
echo "Раздел не найден.";
}Примечание: Метод не проверяет, активен ли раздел или не является ли он устаревшей записью. Для фильтрации по активности рекомендуется использовать дополнительные проверки.
Описание метода CIBlockSection::GetByID в официальной документации Битрикс
Количество показов: 618
Дата изменения: 23.06.2025 13:30:46