4D v14.3

DOCUMENT TO BLOB

ホーム

 
4D v14.3
DOCUMENT TO BLOB

DOCUMENT TO BLOB 


 

DOCUMENT TO BLOB ( document ; BLOB {; *} ) 
引数   説明
document  文字 in ドキュメント名
BLOB  BLOB in ドキュメントを受け取るBLOBフィールドまたは変数
in ドキュメントの内容
演算子 in Macintoshのみ: * が渡されればリソースフォークをロード そうでなければデータフォークをロード

説明   

DOCUMENT TO BLOB は、documentの内容全体をblobにロードします。開かれていない既存のドキュメントを渡さなければなりません。そうでなければエラーが生成されます。ドキュメントをユーザが選択できるようにするには、Open documentおよびプロセス変数documentを使用します(例を参照)。

Macintoshでの注意点

Macintoshのドキュメントファイルは、データフォークおよびリソースフォークの2つから構成されていることがあります。デフォルトで、DOCUMENT TO BLOBコマンドはドキュメントファイルのデータフォークを読み込みます。リソースフォークを読み込むには、オプション引数 * を渡します。Windowsでは、オプション引数 * は無視されます。
4D 環境はWindows上でMac OS リソースフォークと同様のものを提供していることに留意してください。例えば、4Dデータベースのデータフォークは拡張子.4DBのファイルに格納され、 リソースフォークは同じ名前の拡張子.RSRのファイルに格納されます。Windowsでは、BLOBに格納されるデータフォークやリソースフォークを扱 うには、フォークに対応するファイルにアクセスします。

例題  

以下の例は、ドキュメントファイルをすばやく格納、または取得できるような情報システムを記述する場合を想定します。データ入力フォームで、ドキュ メントファイルをBLOBフィールドにロードできるようなボタンを作成します。このボタンに以下のようなメソッドを作成します:

 $vhDocRef:=Open document("") ` ドキュメントを選択させる
 If(OK=1) ` ドキュメントが選択されたら
    CLOSE DOCUMENT($vhDocRef` それを閉じる
    DOCUMENT TO BLOB(Document;[YourTable]YourBLOBField` ドキュメントをロード
    If(OK=0)
  ` エラー処理
    End if
 End if

ドキュメントが正しくロードされると、OK変数は1に設定されます。そうでなければ0に設定され、エラーが生成されます。

  • 存在しないドキュメントファイルや、既に他のプロセスやアプリケーションで開かれているドキュメントファイルを(BLOBに)ロードしようとすると、それぞれに対応するファイルマネージャエラーが生成されます。
  • ドキュメントファイルがロックされていたり、ロックされているボリュームにあったり、ドキュメントファイルを読み込む際に問題が発生すると、I/Oエラーが発生する場合があります。
  • メモリ不足のためにドキュメントファイルをロードできない場合には、エラー-108が生成されます。

いずれの場合でも、ON ERR CALL割り込みメソッドを使用すれば、このエラーをとらえることができます。

 
プロパティ 

プロダクト: 4D
テーマ: BLOB
番号: 525

このコマンドはOKシステム変数を更新しますMac OS用です。

 
履歴 

初出: 4D v6

 
参照 

BLOB TO DOCUMENT
Open document

 
タグ 

Document, Data fork, Resource fork, Storing documents

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v11 SQL Release 6)
ランゲージリファレンス ( 4D v12.4)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)