Вставляет новую строку в таблицу значений на место с указанным индексом.
Синтаксис
Метод Вставить() имеет следующий синтаксис:
СтрокаТаблицыЗначений Вставить(Индекс)
А также альтернативный англоязычный синтаксис:
ValueTableString Insert(Index)
Параметры
Описание параметров метода Вставить():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Индекс | Число | Индекс вставляемой строки. |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
СтрокаТаблицыЗначений — добавленная строка
Описание
Метод Вставить() вставляет новую строку в таблицу значений на место с указанным индексом. При этом индексы строк, расположенных после добавленной, инкрементируются (увеличиваются на единицу).
В том случае, если таблица пустая, либо указанный
Индекс превышает количество строк в таблице значений, новая строка будет добавлена в конец таблицы.Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Сервер, Клиент, Внешнее соединение |
| 8.2 | Сервер, Толстый клиент, Внешнее соединение |
| 8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Вставить():
//создадим новую таблицу тз = Новый ТаблицаЗначений; тз.Колонки.Добавить("Код"); тз.Колонки.Добавить("Наименование"); тз.Колонки.Добавить("Количество"); //заполним таблицу методом вставки //каждая новая строка будет добавлена в начало таблицы НоваяСтрока = тз.Вставить(0); НоваяСтрока.Код = "001"; НоваяСтрока.Наименование = "Стул деревянный"; НоваяСтрока.Количество = 1; НоваяСтрока = тз.Вставить(0); НоваяСтрока.Код = "002"; НоваяСтрока.Наименование = "Стол деревянный"; НоваяСтрока.Количество = 2; НоваяСтрока = тз.Вставить(0); НоваяСтрока.Код = "003"; НоваяСтрока.Наименование = "Шкаф для одежды"; НоваяСтрока.Количество = 2; тз.ВыбратьСтроку("Выберите строку...");