Метод 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 и обратная связь.