CopyDatabaseFile メソッド (Access)DoCmd.CopyDatabaseFile method (Access)

カレント プロジェクトに接続されたデータベースを SQL Server データベース ファイルにコピーしてエクスポートします。Copies the database connected to the current project to a Microsoft SQL Server database file for export.

構文Syntax

CopyDatabaseFile(databasefilename, OverwriteExistingFile, DisconnectAllUsers)expression.CopyDatabaseFile (DatabaseFileName, OverwriteExistingFile, DisconnectAllUsers)

expression: DoCmd オブジェクトを表す変数。expression A variable that represents a DoCmd object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
databasefilenameDatabaseFileName 必須Required バリアント型Variant カレント データベースのコピー先のファイル名 (およびパス) です。The name of the file (and path) to which the current database is copied. パスを指定しないと、カレント ディレクトリが使われます。If no path is specified, the current directory is used.
OverwriteExistingFileOverwriteExistingFile 省略可能Optional VariantVariant DatabaseFileName で指定したファイルが上書きされるかどうかを決定します。Determines whether Microsoft Access overwrites the file specified by DatabaseFileName. 既存のファイルを上書きするには、 True を指定します。True to overwrite the existing file. ファイルが存在しない場合、この引数は無視されます。If the file doesn't already exist, this argument is ignored.
DisconnectAllUsersDisconnectAllUsers 省略可能Optional VariantVariant 現在のデータベースに接続されているすべてのユーザーがコピーを作成できるかどうかを指定します。Determines whether Access disconnects any users connected to the current database to make the copy. データベース ファイルをコピーするときに他のユーザーを切断するには、True を指定します。True to disconnect other users before copying the database file.

注釈Remarks

コピーのファイル名には、SQL Server データベースファイルとして認識される .mdf 拡張子が付いている必要があります。The file name of the copy must have an .mdf extension to be recognized as a SQL Server database file.

次のいずれかが発生すると、このメソッドは異常終了し、エラーが発生します。The method fails and an error occurs if any of the following occurs:

  • _DisconnectAllUsers_はTrueですが、Access は他のユーザーにサインインできません。DisconnectAllUsers is True but Access is unable to sign off other users.

  • 開いているデザイン セッションで保存操作がキャンセルされた。The method cancels a save operation by any open design sessions.

  • 宛先ファイルは存在しますが、 _OverwriteExistingFile_がTrueに設定されていません。The destination file exists but OverwriteExistingFile was not set to True.

  • コピー先ファイルが存在するが、別のアプリケーションで使用中である。The destination file exists, but is in use by another application.

  • 元の .mdf ファイルに再接続できない。Access could not reconnect the original .mdf file.

  • Access プロジェクトの現在のユーザーに、データベースサーバーに対するシステム管理者権限がありません。The current user for the Access project doesn't have system administrator privileges for the database server.

Example

次の例では、カレント プロジェクトに接続されたデータベースが SQL Server データベース ファイルにコピーされます。This example copies the database connected to the current project to a SQL Server database file. ファイルが既に存在していれば、既存のファイルは上書きされ、データベースに接続されているほかのユーザーがコピー前に切断されます。If the file exists already, Access overwrites it, and any other users connected to the database are disconnected before the copy is made.

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

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.