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