OnBeforeIBlockAdd

bool
event_handler(
   array &arParams 
);

The event OnBeforeIBlockAdd is fired from CIBlock::Add before adding a new information block. Can be used to cancel the operation or to redefine fields.

Parameters

Parameter	Description
arParams	An array of the new information block fields.

Note
The parameter(s) of this handler are references to the original variables. Hence, altering their values from within the handler causes changing values of the source variables passed to the handler.

Return Values

To cancel operation and terminate CIBlock::Add, throw an exception by calling ThrowException() and return false.

Example

 
<?
// file /bitrix/php_interface/init.php
// register handler
AddEventHandler("iblock", "OnBeforeIBlockAdd", Array("MyClass", "OnBeforeIBlockAddHandler"));

class MyClass
{
    // create handler "OnBeforeIBlockAdd"
    public static function OnBeforeIBlockAddHandler(&$arFields)
    {
        if(strlen($arFields["CODE"])<=0)
        {
            global $APPLICATION;
            $APPLICATION->throwException("Enter the mnemonic code.");
            return false;
        }
    }
}
?>

OnBeforeIBlockAdd

Parameters

Return Values

See Also

Example