Возвращает копию текущей таблицы значений
Метод Скопировать()
имеет несколько вариантов синтаксиса:
Вариант синтаксиса 1: копирование по строкам и колонкам
Синтаксис метода, позволяющий скопировать определенные строки таблицы значений, выглядит так:
ТаблицаЗначений Скопировать([Строки], [Колонки])
А также альтернативный англоязычный синтаксис:
ValueTable Copy([StringArray], [Columns])
Параметры
Описание параметров метода Скопировать()
:
Имя параметра | Тип | Описание |
---|---|---|
Строки (необязательный) | Массив | Массив строк для копирования. Если параметр не указан, копируются все строки таблицы значений |
Колонки (необязательный) | Строка | Перечисление имен копируемых колонок через запятую. Если параметр не указан, будут скопированы все колонки |
Жирным шрифтом выделены обязательные параметры |
Возвращаемое значение
ТаблицаЗначений
Описание варианта 1
Метод Скопировать()
возвращает копию текущей таблицы значений. Если указан параметр Строки
, то копируются только указанные строки. Если указан параметр Колонки
, то копируются значения только для указанных колонок. Если оба параметра опущены, создается полная копия текущей таблицы значений.
Вариант синтаксиса 2: копирование по отбору
Синтаксис метода, позволяющий скопировать строки по настроенному отбору, выглядит так:
ТаблицаЗначений Скопировать([ПараметрыОтбора], [Колонки])
А также альтернативный англоязычный синтаксис:
ValueTable Copy([Filter], [Columns])
Параметры
Описание параметров метода Скопировать()
:
Имя параметра | Тип | Описание |
---|---|---|
ПараметрыОтбора (необязательный) | Структура | Ключ структуры — идентификатор колонки, а значение структуры — значение отбора. |
Колонки (необязательный) | Строка | Перечисление имен копируемых колонок через запятую. Если параметр не указан, будут скопированы все колонки |
Жирным шрифтом выделены обязательные параметры |
Возвращаемое значение
ТаблицаЗначений
Описание варианта 2
Метод Скопировать()
возвращает копию текущей таблицы значений. Если указан параметр ПараметрыОтбора
, то копируются только строки, удовлетворяющие условиям отбора. Если указан параметр Колонки
, то копируются значения только для указанных колонок. Если оба параметра опущены, создается полная копия текущей таблицы значений.
Доступность
Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).
Пример использования
Пример кода с использованием метода Скопировать()
:
//вариант 1: создание полной копии тзКопия = тз.Скопировать(); //вариант 2: копирование только найденных строк мНайдСтроки = тз.НайтиСтроки(Новый Структура("Категория", "Товары")); тзКопия = тз.Скопировать(мНайдСтроки); //вариант 3: копирование по отбору тзКопия = тз.Скопировать(Новый Структура("Категория", "Услуги"));
Читайте также:
Программная работа с таблицей значений