DoCmd.CopyDatabaseFile-Methode (Access)

Kopiert die mit dem aktuellen Projekt verbundene Datenbank zum Exportieren in eine Microsoft SQL Server-Datenbank.

Syntax

Ausdruck. CopyDatabaseFile (DatabaseFileName, OverwriteExistingFile, DisconnectAllUsers)

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
DatabaseFileName Erforderlich Variant Der Name der Datei (und der Pfad), in die die aktuelle Datenbank kopiert wird. Wenn kein Pfad angegeben ist, wird das aktuelle Verzeichnis verwendet.
OverwriteExistingFile Optional Variant Bestimmt, ob die durch Datenbankname angegebene Datei in Microsoft Access überschrieben wird. Mit True wird die vorhandene Datei überschrieben. Wenn die Datei noch nicht vorhanden ist, wird dieses Argument ignoriert.
DisconnectAllUsers Optional Variant Bestimmt, ob Access alle Benutzer trennt, die mit der aktuellen Datenbank verbunden sind, um die Kopie zu erstellen. Mit True werden andere Benutzer getrennt, bevor die Datenbankdatei kopiert wird.

HinwBemerkungeneise

Der Dateiname der Kopie muss eine MDF-Erweiterung aufweisen, um als SQL Server Datenbankdatei erkannt zu werden.

In folgenden Situationen schlägt diese Methode fehl, und ein Fehler tritt auf:

  • DisconnectAllUsers ist true , aber Access kann andere Benutzer nicht abmelden.

  • Die Methode storniert einen Speichervorgang durch eine geöffnete Entwurfssitzung.

  • Die Zieldatei ist vorhanden, aber Datei überschreiben wurde nicht auf True festgelegt.

  • Die Zieldatei ist vorhanden, wird jedoch von einer anderen Anwendung benutzt.

  • Microsoft Access konnte keine erneute Verbindung zur ursprünglichen MDF-Datei herstellen.

  • Der aktuelle Benutzer für das Access-Projekt verfügt nicht über Systemadministratorberechtigungen für den Datenbankserver.

Beispiel

Das folgende Beispiel kopiert die mit dem aktuellen Projekt verbundene Datenbank in eine SQL Server-Datenbankdatei. Falls die Datei bereits vorhanden ist, wird sie von Microsoft Access überschrieben und andere mit der Datenbank verbundene Benutzer werden getrennt, bevor der Kopiervorgang durchgeführt wird.

DoCmd.CopySQLDatabaseFile _ 
 DatabaseFileName:="C:\Export\Sales.mdf", _ 
 OverwriteExistingFile:=True, _ 
 DisconnectAllUsers:=True

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.