OnBeforeIBlockSectionAdd

Описание и параметры

bool функция-обработчик(
	array &arParams 
);

Событие вызывается в методе CIBlockSection::Add до вставки информационного блока, и может быть использовано для отмены вставки или переопределения некоторых полей.

Параметры

Параметр	Описание
arParams	Массив полей нового раздела информационного блока.

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

Для отмены добавления и прекращении выполнения метода CIBlockSection::Add необходимо в функции-обработчике создать исключение методом $APPLICATION->ThrowException() и вернуть false.

Смотрите также

• Событие "OnAfterIBlockSectionAdd"
• CIBlockSection::Add
• Обработка событий

Пример функции-обработчика

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("iblock", "OnBeforeIBlockSectionAdd", Array("MyClass", "OnBeforeIBlockSectionAddHandler"));

class MyClass
{
	// создаем обработчик события "OnBeforeIBlockSectionAdd"
	public static function OnBeforeIBlockSectionAddHandler(&$arFields)
	{
		if(strlen($arFields["CODE"])<=0)
		{
			global $APPLICATION;
			$aMsg = array();
			$aMsg[] = array("id"=>"CODE", "text"=>"Введите символьный код.");
			$e = new CAdminException($aMsg);
			$APPLICATION->throwException($e);
			return false;
		}
	}
}
?>