Документация для разработчиков
Темная тема

OnBeforeUserUpdate

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

bool функция-обработчик(
	array &arParams 
);
Событие вызывается в методе CUser::Update до изменения параметров пользователя, и может быть использовано для отмены изменения или переопределения некоторых полей.

Параметры

ПараметрОписание
arParams Массив полей изменяемого пользователя.

Примечание. Все параметры данного обработчика являются ссылками на исходные переменные. Поэтому если вы измените значение параметра внутри обработчика, это приведет к смене значения исходной переменной поступившей на вход функции-обработчика.

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

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

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

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("main", "OnBeforeUserUpdate", Array("MyClass", "OnBeforeUserUpdateHandler"));
class MyClass { // создаем обработчик события "OnBeforeUserUpdate" public static function OnBeforeUserUpdateHandler(&$arFields) { if(is_set($arFields, "LAST_NAME") && strlen($arFields["LAST_NAME"])<=0) { global $APPLICATION; $APPLICATION->throwException("Пожалуйста, введите фамилию. (ID:".$arFields["ID"].")"); return false; } } } ?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024