Метод DoCmd.CopyObject (Access)

Метод CopyObject выполняет действие CopyObject в Visual Basic.

Синтаксис

expression. CopyObject (DestinationDatabase, NewName, SourceObjectType, SourceObjectName)

expression: переменная, представляющая объект DoCmd.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
DestinationDatabase	Необязательный	Variant	Строковое выражение, которое является допустимым путем и именем файла для базы данных, в которую требуется скопировать объект. Чтобы выбрать текущую базу данных, оставьте этот аргумент пустым. ПРИМЕЧАНИЕ. В проекте Microsoft Access (ADP) необходимо оставить аргумент DestinationDatabase пустым. Если выполнить код Visual Basic, содержащий метод CopyObject в базе данных библиотеки, и оставить этот аргумент пустым, Access копирует объект в базу данных библиотеки.
Newname	Необязательный	Variant	Строковое выражение, которое является новым именем объекта, который требуется скопировать. Чтобы использовать то же имя при копировании в другую базу данных, оставьте этот аргумент пустым.
SourceObjectType	Необязательный	AcObjectType	Константа AcObjectType , представляющая тип объекта для копирования.
SourceObjectName	Необязательный	Variant	Строковое выражение, которое является допустимым именем объекта типа, выбранного аргументом SourceObjectType . При выполнении кода Visual Basic, содержащего метод CopyObject , в базе данных библиотеки Access ищет объект с этим именем сначала в базе данных библиотеки, а затем в текущей базе данных.

Замечания

Используйте действие CopyObject, чтобы скопировать указанный объект базы данных в другую базу данных Access или в ту же базу данных или проект Access (ADP) под новым именем. Например, можно скопировать или создать резервную копию существующего объекта в другой базе данных или быстро создать аналогичный объект с несколькими изменениями.

Необходимо включить аргумент DestinationDatabase или NewName или оба аргумента для этого метода.

Если оставить аргументы SourceObjectType и SourceObjectName пустыми (предполагается константа по умолчанию acDefault для SourceObjectType), Access копирует объект, выбранный в окне База данных. Чтобы выбрать объект в окне База данных, можно использовать действие SelectObject или метод SelectObject с аргументом InDatabaseWindow , равным Да (True).

Если указать аргументы SourceObjectType и SourceObjectName , но оставить аргумент NewName или аргумент DestinationDatabase пустым, необходимо включить запятую аргумента NewName или DestinationDatabase . Если оставить конечный аргумент пустым, не используйте запятую после последнего указанного аргумента.

Пример

В следующем примере метод CopyObject используется для копирования таблицы Employees и присвоения ей нового имени в текущей базе данных.

DoCmd.CopyObject, "Employees Copy", acTable, "Employees"

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.