Загружает значения из массива в заданную колонку коллекции строк дерева значений.
Синтаксис
ЗагрузитьКолонку(<Массив>, <Колонка>)Примеры платформы
СтрокиСостава.ЗагрузитьКолонку(МассивЗатрат, "Затрата");Полное описание, параметры и ограничения
КоллекцияСтрокДереваЗначений.ЗагрузитьКолонку (ValueTreeRowCollection.LoadColumn)
КоллекцияСтрокДереваЗначений (ValueTreeRowCollection)
ЗагрузитьКолонку (LoadColumn)
Доступен, начиная с версии 8.0.
Синтаксис:
ЗагрузитьКолонку(<Массив>, <Колонка>)
Параметры:
<Массив> (обязательный)
Тип: Массив.
Массив значений для загрузки в колонку.
<Колонка> (обязательный)
Тип: Число, Строка, КолонкаДереваЗначений.
Колонка коллекции, в которую будут загружены значения из массива.
В качестве значения параметра может быть передан индекс колонки, имя колонки, либо колонка дерева значений.
Описание:
Загружает значения из массива в заданную колонку коллекции строк дерева значений.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Значения из массива загружаются в колонку в порядке индексов.
Пример:
СтрокиСостава.ЗагрузитьКолонку(МассивЗатрат, "Затрата");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Изменить порядок товаров внутри одной категории
Коллекция дочерних строк изменяется независимо от соседних категорий. Загружаем новые количества из массива и очищаем только копию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст. Здесь одна категория; изменяем именно её коллекцию Строки.
Массив количеств содержит столько элементов, сколько дочерних строк в момент загрузки.
Категории = Новый ДеревоЗначений;
Категории.Колонки.Добавить("Название");
Категории.Колонки.Добавить("Количество");
Группа = Категории.Строки.Добавить();
Группа.Название = "Канцелярия";
Строки = Группа.Строки;
Строки.Добавить().Название = "Ручка";
Строки.Добавить().Название = "Карандаш";
Срочный = Строки.Вставить(1);
Срочный.Название = "Тетрадь";
Строки.Сдвинуть(Срочный, -1);
Сообщить(Строки.Индекс(Срочный));
Количества = Новый Массив;
Количества.Добавить(5);
Количества.Добавить(2);
Количества.Добавить(1);
Строки.ЗагрузитьКолонку(Количества, "Количество");
Выгруженные = Строки.ВыгрузитьКолонку("Количество");
Сообщить(Выгруженные[0]);
Сообщить(Строки.Количество());
Строки.Удалить(Срочный);
Сообщить(Строки.Количество());
Копия = Категории.Скопировать();
Копия.Строки.Получить(0).Строки.Очистить();
Сообщить(Копия.Строки.Получить(0).Строки.Количество());
Сообщить(Группа.Строки.Количество());Разбор по шагам
Создаём две строки, вставляем тетрадь между ними и перемещаем её в начало.
ЗагрузитьКолонку связывает элементы массива с позициями строк; первое количество относится к тетради.
ВыгрузитьКолонку возвращает массив значений текущего уровня.
Удаляем тетрадь по объекту строки, очищаем потомков отдельной копии дерева.
Как проверить результат
Индекс тетради равен 0, её количество после загрузки — 5; до удаления 3 строки, после 2.
У копии дочерних строк 0, у исходной группы остаётся 2.
Ожидаемый результат
В исходной группе остаются ручка и карандаш с количествами 2 и 1.
На что обратить внимание
Загрузка массива зависит от текущего порядка: сортировка перед загрузкой меняет соответствие строк и значений.
Очистить на корневых Строки удалит всё дерево; здесь очищается только коллекция потомков копии.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.