РегистрСведенийНаборЗаписей.<Имя регистра сведений>.Записать (InformationRegisterRecordSet.<Information register name>.Write)

РегистрСведенийНаборЗаписей.<Имя регистра сведений> (InformationRegisterRecordSet.<Information register name>)

Записать (Write)

Доступен, начиная с версии 8.0.

Синтаксис:

Записать(<Замещать>)

Параметры:

<Замещать> (необязательный)

Тип: Булево, РежимЗамещения.
Определяет режим замещения существующих записей в соответствии с текущими установками отбора:

Истина или Замещение - перед записью существующие записи будут удалены.
Ложь или Добавление - записи будут дописаны к уже существующим в информационной базе записям.
Обновление - существующие записи регистра, совпадающие по значениям ключевых полей (Период, измерения, разделители - для независимого регистра, Регистратор, НомерСтроки, разделители - для подчиненного) с записями набора записей будут перезаписаны. Если для какой-либо записи набора записей нет соответствующей записи регистра, будет сгенерировано исключение.
Слияние - будет произведено слияние записей из набора записей с существующими записями регистра. Существующие записи регистра, совпадающие с записями набора записей по значениям ключевых полей (Период, измерения, значения разделителей), будут перезаписаны, а записи набора, для которых нет соответствия среди существующих записей регистра, будут добавлены в регистр. Данное значение параметра допустимо только для независимых регистров сведений.
Удаление - записи регистра, совпадающие с записями набора записей по значениям ключевых полей, будут удалены из регистра.

Значения параметров Удаление или Обновление для набора записей подчиненного регистра сведений могут быть использованы только в том случае, если свойство ДлинаНомераСтроки набора записей имеет значение Истина.
Значение по умолчанию: Истина.

Описание:

Записывает набор записей в базу данных. В зависимости от переданного параметра, может быть выполнено добавление записей или их замещение.
Если для регистра сведений подчиненного регистратору производится запись в режиме добавления, то после выполнения записи набор очищается.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Примечание:

Для регистров сведений, подчиненных регистратору, при вызове с параметром <Замещать> равным Ложь после записи в информационную базу набор записей очищается (удаляются записи из набора).

Пример:

НаборКурсов.Записать();

Использование в версии:

Доступен, начиная с версии 8.0.

Описание изменено в версии 8.3.26.

Методическая информация