Добавляет новый элемент коллекции и возвращает его.
Синтаксис
Добавить(<Элемент>)Полное описание, параметры и ограничения
СоставКопииБазыДанных.Добавить (DatabaseCopyContent.Add)
СоставКопииБазыДанных (DatabaseCopyContent)
Добавить (Add)
Доступен, начиная с версии 8.3.14 (в режиме совместимости с версией 8.3.14 и последующими).
Синтаксис:
Добавить(<Элемент>)
Параметры:
<Элемент> (необязательный)
Тип: ЭлементСоставаКопииБазыДанных.
Добавляемый элемент.
В режиме совместимости с Версия8_3_15 и старше параметр является необязательным.
В этом случае объект метаданных можно установить позже через свойство Метаданные, доступное на запись.
Возвращаемое значение:
Тип: ЭлементСоставаКопииБазыДанных.
Описание:
Добавляет новый элемент коллекции и возвращает его.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.14 (в режиме совместимости с версией 8.3.14 и последующими).
Методическая информация
Практические примеры
Добавить настоящий элемент состава другой своей копии
Аргумент Добавить — ЭлементСоставаКопииБазыДанных. Берём его из реального состава своей подготовленной копии, не создаём неизвестный объект.
Где и как запускать
Синтаксис для серверного обработчика своей учебной базы. Метаданные и сервисы должны быть подготовлены заранее. Здесь 1С, базы данных, файлы и сеть не использовались.
Подготовка
Подготовьте две свои отдельные учебные копии и один собственный объект метаданных в составе источника. В назначении его ещё не должно быть.
Пример показывает редактирование описания состава, без Записать и без обновления данных копии.
Источник = КопииБазыДанных.Найти("УчебнаяКопияИсточник");
Назначение = КопииБазыДанных.Найти("УчебнаяКопияНазначение");
Если Источник = Неопределено Или Назначение = Неопределено Тогда
ВызватьИсключение "Подготовьте обе собственные учебные копии";
КонецЕсли;
Если Источник.Состав.Количество() = 0 Тогда
ВызватьИсключение "Нужен реальный элемент исходного состава";
КонецЕсли;
Элемент = Источник.Состав.Получить(0);
Добавленный = Назначение.Состав.Добавить(Элемент);
Сообщить(Добавленный.Метаданные.ПолноеИмя());Разбор по шагам
Получите обе настоящие копии.
Возьмите существующий элемент непустого исходного состава.
Передайте этот объект в Добавить и используйте фактически возвращённый элемент.
Как проверить результат
Метаданные получены от реального элемента, не подставлены готовой строкой.
Не вызывается несовместимый no-arg вариант с обещанием создать неизвестный тип.
Ожидаемый результат
Это короткий синтаксический пример для указанного учебного стенда. Здесь он не выполнялся; сообщение после вызова не заменяет отдельную проверку фактического состояния.
На что обратить внимание
Необязательность аргумента в старом режиме совместимости не означает, что такой вариант годится во всех режимах.
Ограничение владения или дублирование может дать отказ; успешная запись и копирование данных не обещаются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.