Méthode DoCmd.CopyDatabaseFile (Access)

Copie la base de données connectée au projet actif à un fichier de base de données Microsoft SQL Server pour l'exporter.

Syntaxe

expression. CopyDatabaseFile (DatabaseFileName, OverwriteExistingFile, DisconnectAllUsers)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
DatabaseFileName	Obligatoire	Variant	Nom du fichier (et chemin d'accès) où est copié la base de données active. Si aucun chemin d'accès n'est spécifié, le répertoire actif est utilisé.
OverwriteExistingFile	Facultatif	Variant	Détermine si Microsoft Access remplace le fichier spécifié par DatabaseFileName. True pour remplacer le fichier existant. Si le fichier n’existe pas déjà, cet argument est ignoré.
DisconnectAllUsers	Facultatif	Variant	Détermine si Access déconnecte tous les utilisateurs connectés à la base de données active pour effectuer la copie. True pour déconnecter d'autres utilisateurs avant de copier le fichier de base de données.

Remarques

Le nom de fichier de la copie doit avoir une extension .mdf pour être reconnu comme un fichier de base de données SQL Server.

La méthode échoue et une erreur se produit dans les cas suivants :

• DisconnectAllUsers a lavaleur True , mais Access ne peut pas déconnecter les autres utilisateurs.

• La méthode annule une opération d'enregistrement d'une session de création active.

• Le fichier de destination existe, mais OverwriteExistingFile n’a pas la valeur True.

• Le fichier de destination existe, mais il est utilisé par une autre application.

• Access n'a pas pu se reconnecter au fichier .mdf d'origine.

• L’utilisateur actuel du projet Access ne dispose pas des privilèges d’administrateur système pour le serveur de base de données.

Exemple

Cet exemple permet de copier la base de données connectée au projet actif à un fichier de base de données SQL Server. Si le fichier existe déjà, Access le remplace, et les autres utilisateurs connectés à la base de données sont déconnectés avant l'exécution de la copie.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.