Add
Описание
int CIBlockSection::Add( array arFields, bool bResort = true, bool bUpdateSearch = true, bool bResizePictures = false );
Метод добавляет новый раздел в информационный блок. Перед добавлением раздела вызываются обработчики события OnBeforeIBlockSectionAdd из которых можно изменить значения полей или отменить добавление раздела вернув сообщение об ошибке. После добавления раздела вызывается событие OnAfterIBlockSectionAdd. Нестатический метод.
Смотрите также
Параметры вызова
Параметр | Описание | С версии |
---|---|---|
arFields | Массив вида Array("поле"=>"значение", ...), содержащий значения полей раздела инфоблоков.
Пользовательские свойства UF_XXX можно тоже занести в массив и они будут добавляться. | |
bResort | Флаг, указывающий пересчитывать ли правую и левую границы после изменения (поля LEFT_MARGIN и RIGHT_MARGIN).
Примечание: настоятельно рекомендуется не устанавливать значение false.
| 3.2.1 |
bUpdateSearch | Флаг, указывающий, что раздел должен быть проиндексирован для поиска сразу же после сохранения. | 4.0.6 |
bResizePictures | Использовать настройки инфоблока для обработки изображений. По умолчанию настройки не применяются. Если этот параметр имеет значение true, то к полям PICTURE и DETAIL_PICTURE будут применены правила генерации и масштабирования в соответствии с настройками информационного блока. | 9.0.4 |
Возвращаемое значение
Метод возвращает идентификационный код добавленного раздела блока, если добавление прошло успешно. При возникновении ошибки метод вернет false, а в свойстве объекта LAST_ERROR будет содержаться текст ошибки.Примеры использования
<? $bs = new CIBlockSection; $arFields = Array( "ACTIVE" => $ACTIVE, "IBLOCK_SECTION_ID" => $IBLOCK_SECTION_ID, "IBLOCK_ID" => $IBLOCK_ID, "NAME" => $NAME, "SORT" => $SORT, "PICTURE" => $_FILES["PICTURE"], "DESCRIPTION" => $DESCRIPTION, "DESCRIPTION_TYPE" => $DESCRIPTION_TYPE ); if($ID > 0) { $res = $bs->Update($ID, $arFields); } else { $ID = $bs->Add($arFields); $res = ($ID>0); } if(!$res) echo $bs->LAST_ERROR; ?>
© «Битрикс», 2001-2024, «1С-Битрикс», 2024