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