Методы
Синтаксис:
Вставить{<Индекс>)
Параметры:
<Индекс> Обязательный
Тип: Число. Индекс позиции, на которую надо вставить новую запись.
Возвращаемое значение:
Тип:РегистрСведенийЗапись.<Имя регистра сведений>. Созданная запись регистра.
Описание:
Позволяет вставить новую запись в набор на указанную позицию.
Важно! Метод доступен только для набора записей регистра сведений, в котором записи подчинены регистратору.
Пример:
НоваяЦена = НаборЦенКонкурентов.Вставить(0);
Синтаксис:
Выбран()
Возвращаемое значение:
Тип: Булево. Истина, если не изменялся.
Ложь, если изменялся. В частности, если набор не считывался и не записывался, а также если записывался с добавлением записей.
Описание:
Позволяет определить считан ли набор записей.
Примечание:
При изменении отбора считается, что набор перестает быть считанным.
Пример:
Если Не НаборКурсов.Выбран() Тогда НаборКурсов.Прочитать() ;
КонеиЕсли;
Синтаксис:
Выгрузить()
Возвращаемое значение:
Тип: ТаблицаЗначений. Созданная таблица значений.
Описание:
Позволяет скопировать в таблицу значений все записи набора. Структура полученной таблицы совпадает со структурой набора записей.
Пример:
ТаблицаКурсов = НаборКурсов.Выгрузить();
ВыгрузитьКолонку( UnloadColumn )
Синтаксис:
ВыгрузитьКолонку(<Имя поля>)
Параметры:
<Имя поля> Обязательный
Тип: Строка. Имя поля записей набора, значения из которого будут выгружены в массив.
Возвращаемое значение:
Тип: Массив. Сформированный массив значений.
Описание:
Позволяет выгрузить значения заданного поля у записей набора в массив значений. Значения записей выгружаются в элементы массива, имеющие тот же индекс.
Пример:
МассивКурсов = НаборКурсов.ВыгрузитьКолонку("Курс");
Синтаксис:
Добавить()
Возвращаемое значение:
Тип: РегистрСведенийЗапись.<Имя регистра сведений>. Запись регистра сведений, помещенная в набор.
Описание:
Позволяет создать новую запись в наборе.
Пример:
НовыйКурс = НаборКурсов.Добавить();
Загрузить( Load )
Синтаксис:
Загрузить(<Таблица значений>)
Параметры:
<Таблица значений> Обязательный
Тип: ТаблицаЗначений. Таблица значений, по которой производится заполнение набора записей.
Описание:
Очищает набор записей и заполняет его значениями из переданной таблицы значений. Заполняются значения у колонок, имена которых совпали.
Пример:
НаборКурсов.Загрузить(ТаблКурсов) ;
ЗагрузитьКолонку ( LoadColumn )
Синтаксис:
ЗагрузитьКолонку (<Массив>, <Имя поля>)
Параметры:
<Массив> Обязательный
Тип: Массив. Массив, содержащий значения для заполнения колонки набора.
<Имя поля> Обязательный
Тип: Строка. Имя поля записей набора, в которое будут загружаться значения из массива.
Описание:
Позволяет заполнить заданное поле у записей набора значениями, взятыми из массива. Значения записей заполняются из элементов массива, имеющих тот же индекс.
Пример:
НаборКурсов.ЗагрузитьКолонку(МассивКурсов, "Курс");
Записать ( Write )
Синтаксис:
Записать (< 3амещать> )
Параметры:
<3амещать> Необязательный
Тип: Булево. Замещать записи по установленному отбору. Если значение параметра Истина, то перед записью существующие записи будут удалены.
Значение по умолчанию: Истина.
Описание:
Позволяет записать набор записей в информационную базу. В зависимости от переданного параметра, может быть выполнено добавление записей или их замещение. Если указано замещение, то перед выполнением записи будет выполнено удаление существующих записей в соответствии с текущими установками отбора, если данный параметр установлен в Ложь, то запись будет выполнена только в случае отсутствия в информационной базе других записей с такими же значениями измерений и периодом (для периодических регистров). Если для регистра сведений, подчиненного регистратору, выполняется добавление записей, то после выполнения записи набор очищается.
Пример:
НаборКурсов.Записать();
Индекс ( IndexOf )
Синтаксис:
Индекс(< Запись>)
Параметры:
<3апись> Обязательный
Тип: РегистрСведенийЗапись.<Имя регистра сведений>. Запись набора, для которой необходимо получить индекс.
Возвращаемое значение:
Тип: Число. Индекс записи в наборе.
Описание:
Позволяет определить индекс записи в наборе.
Пример:
Если НовыйКурс. Индекс() =0 Тогда
Сообщить("Это первая запись о курсе в наборе.");
КонецЕсли ;
Итог ( Total )
Синтаксис:
Итог(<Имя поля>)
Параметры:
<Имя поля> Обязательный
Тип: Строка. Имя поля записей набора, по которому необходимо подсчитать итог.
Возвращаемое значение:
Тип: Число. Числовое значения результата вычисления.
Описание:
Позволяет вычислить итог по одному из полей набора.
Пример:
СреднийКурс = НаборКурсов.Итог("Курс") / НаборКурсов.Количество();
Сообщить("Средний курс " + СреднийКурс);
Количество ( Count )
Синтаксис:
Количество()
Возвращаемое значение:
Тип- Число. Количество записей в наборе.
Описание:
Позволяет получить количество записей в наборе.
Пример:
Для Сч = 0 По НаборКурсов. Количество () -1 Цикл
ДатаКурса = НаборКурсов(Сч].Период;
ТекКурс = НаборКурсов[Сч]-Курс;
Сообщить ("Курс на " + ДатаКурса + " - "+ ТекКурс + " руб.");
КонецЦикла;
Модифицированность ( Modified )
Синтаксис:
Модифицированность()
Возвращаемое значение:
Тип: Булево. Истина - записи изменены.
Ложь - записи не изменены.
Описание:
Позволяет определить, были ли изменены элементы данной коллекции после считывания или записи набора.
Примечание:
Метод не позволяет определить, были ли изменены соответствующие записи в регистре другими пользователями.
Пример:
Если НаборКурсов.Модифицированность () Тогда НаборКурсов.Записать();
КонецЕсли;
Очистить ( Clear )
Синтаксис:
Очистить()
Описание;
Позволяет удалить все записи из набора.
Пример:
НаборКурсов.Очистить();
ПолучитьФорму ( GetForm )
Синтаксис:
ПолучитьФорму (< Форма>, <Владелец> , <Ключ уникальности>)
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет акта визирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму набора записей регистра сведений.
Пример:
НаборКурсов.ПолучитьФорму("ФормаНабораЗаписей").Открыть();
Прочитать ( Read )
Синтаксис:
Прочитать()
Описание:
Позволяет выполнить чтение записей из информационной базы по установленному отбору.
Пример:
КурсыВалют = РегистрыСведений.КурсыВалют;
НаборКурсов = КурсыВалют .СоздатьНаборЗаписей();
НаборКурсов.Прочитать();
Сдвинуть ( Move )
Синтаксис:
Сдвинуть(< Запись>, <Смещение>)
Параметры:
<3апись> Обязательный
Тип: Число, РегистрСведенийЗапись.<Имя регистра сведений>. Индекс сдвигаемой записи либо сама запись.
<Смещение> Обязательный
Тип: Число. Количество позиций, на которое следует сдвинуть запись. Положительное значение соответствует смещению записи в сторону конца списка записей набора (увеличение индекса), отрицательное - к началу.
Описание:
Позволяет сдвинуть запись в наборе на указанное число позиций.
Важно! Метод доступен только для набора записей регистра сведений, в котором записи подчинены регистратору.
Удалить ( Remove )
Синтаксис:
Удалить(< Запись>)
Параметры:
<3апись> Обязательный
Тип: Число, РегистрСведенийЗапись.<Имя регистра сведений>. Индекс удаляемой записи либо сама запись.
Описание:
Позволяет удалить запись из набора.
Пример:
НаборКурсов.Удалить(0);
УстановитьАктивность ( SetActive )
Синтаксис:
УстановитьАктивность (<Активность>)
Параметры:
<Активность> Обязательный
Тип: Булево. Признак активности. Истина - записи активны. Ложь - записи не активны.
Описание:
Позволяет установить значение свойства Активность для всех записей набора.
Пример:
НаборКурсов.УстановитьАктивность(Истина);