Link Search Menu Expand Document

{ИмяРегистраСведений}.НаборЗаписей

Доступность: Сервер

Иерархия типа

graph TD;
ИзменяемыйМассив["ИзменяемыйМассив"]-->ИзменяемаяКоллекция["ИзменяемаяКоллекция"];
ИзменяемыйМассив["ИзменяемыйМассив"]-->ЧитаемыйМассив["ЧитаемыйМассив"];
ЧитаемаяКоллекция["ЧитаемаяКоллекция"]-->Обходимое["Обходимое"];
ЧитаемыйМассив["ЧитаемыйМассив"]-->ЧитаемаяКоллекция["ЧитаемаяКоллекция"];
InformationRegisterName.НаборЗаписей["{ИмяРегистраСведений}.НаборЗаписей"]-->РегистрСведений.НаборЗаписей["РегистрСведений.НаборЗаписей"];
ИзменяемаяКоллекция["ИзменяемаяКоллекция"]-->ЧитаемаяКоллекция["ЧитаемаяКоллекция"];
Обходимое["Обходимое"]-->Объект["Объект"];
Массив["Массив"]-->Коллекция["Коллекция"];
Массив["Массив"]-->ИзменяемыйМассив["ИзменяемыйМассив"];
РегистрСведений.НаборЗаписей["РегистрСведений.НаборЗаписей"]-->ЧитаемыйМассив["ЧитаемыйМассив"];
InformationRegisterName.НаборЗаписей["{ИмяРегистраСведений}.НаборЗаписей"]-->Массив["Массив"];
Коллекция["Коллекция"]-->ИзменяемаяКоллекция["ИзменяемаяКоллекция"];

Набор записей предназначен для записи и чтения из БД набора записей со значениями измерений соответствующими установленному отбору (см. свойство Отбор).

Порядок следования записей в наборе не сохраняется между записью и последующим чтением из БД.

Пример

знч Набор = новый КурсыВалют.НаборЗаписей()
Набор.Отбор.Установить(Период = ДатаЗагрузки)
Набор.ДобавитьВсе(ЗагруженныеКурсы)
Набор.Записать() 

Сравнение ссылочное


Конструкторы

{ИмяРегистраСведений}.НаборЗаписей

InformationRegisterName.НаборЗаписей()
Доступность: Сервер

Конструктор по умолчанию - создаёт пустой набор записей.


Свойства

Отбор

Доступность: Сервер
Переопределение: Отбор

Свойство унаследовано от базового типа, только уточнён тип.


Методы

ПослеЗаписи

ПослеЗаписи(Замещать: Булево)
Доступность: Сервер
Аннотации: Обработчик

Вызывается в транзакции при вызове метода [Записать], после записи элемента в БД. Значение параметра Замещать соответствуют значению переданному при вызове метода [Записать]. Обработчик выполняется в привилегированном режиме.


ПередЗаписью

ПередЗаписью(Замещать: Булево)
Доступность: Сервер
Аннотации: Обработчик

Вызывается при вызове метода [Записать], после того как начата транзакция и захвачена блокировка. Значение параметра Замещать соответствуют значению переданному при вызове метода [Записать].


ДобавитьЗапись

ДобавитьЗапись(
  <Измерение1>: <ТипИзмерения1> = <ЗначениеПоУмолчаниюИзмерения1>,
  ....<ИзмерениеN>: <ТипИзмеренияN> = <ЗначениеПоУмолчаниюИзмеренияN>,
  <Ресурс1>: <ТипРесурса1> = <ЗначениеПоУмолчаниюРесурса1>,
  ...<РесурсN>: <ТипРесурсаN> = <ЗначениеПоУмолчаниюРесурсаN>,
  <Реквизит1>: <ТипРеквизита1> = <ЗначениеПоУмолчаниюРеквизита1>,
  ....<РеквизитN>: <ТипРеквизитаN> = <ЗначениеПоУмолчаниюРеквизитаN>)
Доступность: Сервер

Вызов возможен только с именованными параметрами

Добавляет в набор новую запись и заполняет значения её измерений (и стандартного поля Период, если оно есть) в соответствии с установленным в наборе записей отбором и переданными значениями. Если отбор не инициализирован (см. описание свойство [.Инициализирован] в отборе набора записей регистра сведений) - будет выдана ошибки о неиницализированности отбора. Добавленная запись возвращается в качестве результата вызова.


Записать

Записать(Замещать: Булево = Истина)
Доступность: Сервер
Перегрузка:
Записать(Замещать: Булево = Истина, ПараметрыЗаписи: {ИмяРегистраСведений}.ПараметрыЗаписи)

Записывает набор записей в базу данных. Если отбор не инициализирован (см. описание свойство [.Инициализирован] в отборе набора записей регистра сведений) - будет выдана ошибки о неиницализированности отбора. При наличии в наборе записей не соответствующих отбору - будет выдана ошибка о несоответствии записи отбору. При наличии в наборе записей с одинаковыми ключами записей - будет выдана ошибка о нарушении уникальности записей. Если значение параметра Замещать = Истина, перед записью из таблицы базы данных будут удалены все записи соответствующие отбору (если отбор пустой, но инициализированный - из таблицы будут удалены вообще все записи). Если значение параметра Замещать = Ложь, новые записи будут дописываться к существующим. Если при этом будет обнаружено нарушение уникальности записей в таблице базы данных - будет выдана ошибка о нарушении уникальности записей. При этом если вызов выполнялся в объемлющей транзакции - транзакция становится непригодной для продолжения работы. После записи в режиме Замещать = Ложь набор записей очищается.


Записать

Записать(
  Замещать: Булево = Истина,
  ПараметрыЗаписи: {ИмяРегистраСведений}.ПараметрыЗаписи)
Доступность: Сервер
Перегрузка:
Записать(Замещать: Булево = Истина)

Список унаследованных методов

ИзменяемаяКоллекция

ИзменяемыйМассив

Коллекция

Массив

Обходимое

Объект

РегистрСведений.НаборЗаписей

ЧитаемаяКоллекция

ЧитаемыйМассив