4D Doc Center : OPEN DATA FILE

4D v14.3

OPEN DATA FILE


OPEN DATA FILE ( accessPath )

引数	型	説明
accessPath	文字	開くデータファイルの名前または完全アクセスパス

説明

OPEN DATA FILEコマンドは、4Dアプリケーションによって開かれたデータファイルをオンザフライで変更することを可能にします。

accessPath 引数には、開こうとするデータファイル (".4DD"拡張子を持つファイル) の名前または完全なアクセスパスを渡します。ファイル名だけを渡す場合、データファイルはデータベースのストラクチャファイルと同じ階層に配置されていなければなりません。

アクセスパスが有効なデータファイルを指している場合、4Dは現在使用しているデータベースを終了し、指定されたデータファイルを使って再度開きます。シングルユーザーモードではOn ExitデータベースメソッドとOn Startupデータベースメソッドが続いて呼び出されます。

警告： このコマンドを使用すると、指定されたデータファイルで再びデータベースが開かれる前に、アプリケーションは一度終了します。このためOn Startupデータベースメソッドやこのデータベースメソッドから呼び出されるメソッド内で、このコマンドを使用することはできません。

このコマンドは非同期的に実行されます。つまり、コマンド呼び出しの後、4Dはメソッドの残りの部分を続けて実行します。この後、アプリケーションはファイルメニューの終了コマンドが選択された場合と同様の処理を行います。表示されているダイアログボックスはキャンセルされ、実行中のプロセスは10秒間の猶予の後に打ち切られます。

処理を開始する前に、コマンドは指定されたデータファイルが有効かどうかを検証します。また、そのファイルが既に開かれている場合、コマンドはファイルが現在使用中のストラクチャファイルに対応するかどうかを確認します。

accessPathに空の文字列を渡した場合、このコマンドはデータファイルを変更せずにデータベースを再度開きます。

4D Server: 4D v13より、このコマンドを4D Serverで実行できるようになりました。このコンテキストで、このコマンドは指定されたファイルを開く前に、サーバー上で内部的にQUIT 4Dを呼び出します。結果各接続クライアント上にはサーバーが終了中である旨を通知するダイアログが表示されます。