OPEN DATABASE

4D v16.3

OPEN DATABASE


OPEN DATABASE ( filePath )

引数	型	説明
filePath	文字	開きたいファイル名(.4db、.4dc、.4dbase または .4dlink)、または開きたいデータベースへの完全なアクセスパス

説明

OPEN DATABASE コマンドは、現在開いている4Dデータベースを閉じ、filePath で定義されたデータベースを、動的に開きます。このコマンドは自動的にテストをする目的や、コンパイル後にデータベースを自動的に開くのに有用です。

filePath 引数には、開きたいデータベースの名前または完全なアクセスパスを渡します。指定できるファイルの拡張子は以下のとおりです:

.4db (インタープリタストラクチャーファイル)
.4dc (コンパイルされたストラクチャーファイル)
.4dbase (OS X パッケージ)
.4dlink (ショートカットファイル)

ファイル名のみを渡す場合、現在開いているデータベースのストラクチャーファイルと同じ階層にそのファイルが置かれている必要があります。

アクセスパスが有効なデータベースを設定していた場合、4Dは開いているデータベースを閉じ、指定されたデータベースを開きます。シングルユーザーモードにおいては、閉じられた方のデータベースの On Exitデータベースメソッドと、新たに開かれた方のデータベースのOn Startupデータベースメソッドが順番に開かれます。

注: このコマンドは指定されたデータベースを開く前にアプリケーションを強制的に閉じるため、On Startupデータベースメソッドの中やこのデータベースメソッドから呼び出されるメソッド内で呼び出すことは推奨されません。

このコマンドは非同期的に実行されます。つまり、呼び出しの後、4Dは他のメソッドを実行し続けます。そして、アプリケーションはファイルメニューの4Dを終了コマンドを選択したのと同じ挙動をします。ファイルを開くダイアログボックスはキャンセルされ、開いているプロセスは全て10秒間の猶予の後に終了します。

指定されたデータベースファイルが見つからないか無効である時、標準のファイルシステムエラーが返され、4Dは何もしません。

このコマンドは標準のデータベースからのみ実行する事ができます。組み込まれたアプリケーション(シングルユーザーまたはサーバーどちらでも)から呼び出された場合、エラー-10509"データベースが開けません"が返されます。

例題

OPEN DATABASE("C:\\databases\\Invoices\\Invoices.4db")