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