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