DoCmd.CopyObject-Methode (Access)

Die CopyObject-Methode führt die CopyObject-Aktion in Visual Basic aus.

Syntax

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

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
DestinationDatabase	Optional	Variant	Ein Zeichenfolgenausdruck, der den gültigen Pfad und Dateinamen für die Datenbank darstellt, in die Sie das Objekt kopieren möchten. Wenn Sie die aktuelle Datenbank auswählen möchten, lassen Sie dieses Argument leer. HINWEIS: In einem Microsoft Access-Projekt (ADP) müssen Sie das Argument DestinationDatabase leer lassen. Wenn Sie Visual Basic-Code mit der CopyObject-Methode in einer Bibliotheksdatenbank ausführen und dieses Argument leer lassen, kopiert Access das Objekt in die Bibliotheksdatenbank.
Newname	Optional	Variant	Ein Zeichenfolgenausdruck, der den neuen Namen für das Objekt darstellt, das Sie kopieren möchten. Sie können beim Kopieren in eine andere Datenbank denselben Namen verwenden, indem Sie für dieses Argument keinen Wert angeben.
SourceObjectType	Optional	AcObjectType	Eine AcObjectType-Konstante , die den Typ des zu kopierenden Objekts darstellt.
SourceObjectName	Optional	Variant	Ein Zeichenfolgenausdruck, der den gültigen Namen eines Objekts des typs darstellt, der durch das Argument SourceObjectType ausgewählt wurde. Wenn Sie Visual Basic-Code mit der CopyObject-Methode in einer Bibliotheksdatenbank ausführen, sucht Access zuerst in der Bibliotheksdatenbank und dann in der aktuellen Datenbank nach dem Objekt mit diesem Namen.

HinwBemerkungeneise

Verwenden Sie die CopyObject-Aktion, um das angegebene Datenbankobjekt in eine andere Access-Datenbank oder in die gleiche Datenbank oder dasselbe Access-Projekt (.adp) unter einem neuen Namen zu kopieren. For example, you can copy or back up an existing object in another database or quickly create a similar object with a few changes.

Sie müssen entweder das Argument DestinationDatabase oder NewName oder beides für diese Methode einschließen.

Wenn Sie die Argumente SourceObjectType und SourceObjectName leer lassen (die Standardkonstante acDefault wird für SourceObjectType angenommen), kopiert Access das im Datenbankfenster ausgewählte Objekt. Um ein Objekt im Datenbankfenster auszuwählen, können Sie die SelectObject-Aktion oder die SelectObject-Methode verwenden, wobei das Argument InDatabaseWindow auf Ja (True) festgelegt ist.

Wenn Sie die Argumente SourceObjectType und SourceObjectName angeben, aber entweder das Argument NewName oder das Argument DestinationDatabase leer lassen, müssen Sie das Komma des Arguments NewName oder DestinationDatabase einschließen. Wenn Sie ein nachgestelltes Argument leer lassen, verwenden Sie kein Komma nach dem letzten Argument, das Sie angeben.

Beispiel

Im folgenden Beispiel wird die CopyObject-Methode verwendet, um die Employees-Tabelle zu kopieren und ihr einen neuen Namen in der aktuellen Datenbank zu geben.

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.