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