Stream オブジェクト

データのバイナリまたはテキスト ストリームを表します。

解説

ファイル システムまたは電子メール システムなどの階層化されたツリー構造では、ファイルや電子メールの内容を格納した既定のバイナリ/テキスト ストリームを Record に関連付けることができます。これらのデータ ストリームを格納したフィールドまたはレコードは、Stream オブジェクトを使って操作できます。Stream オブジェクトは次の方法で取得できます。

• バイナリ データまたはテキスト データを格納したオブジェクト (通常はファイル) を指定する URL で取得します。このようなオブジェクトには、単純なドキュメント、構造ドキュメントを表す Record オブジェクト、またはフォルダがあります。
  
  
• Record オブジェクトに関連付けられた既定の Stream オブジェクトを開いて取得します。Record オブジェクトが開いているときにその Record オブジェクトに関連付けられた既定のストリームを取得すると、ストリームを開くときに起こるラウンドトリップを避けることができます。
  
  
• Stream オブジェクトをインスタンス化して取得します。このような Stream オブジェクトは、アプリケーション用のデータの保存に利用できます。URL に関連付けられた Stream、または Record の既定の Stream とは異なり、インスタンス化した Stream は、既定では基になるソースに関連付けられていません。

Stream オブジェクトのコレクションおよびプロパティを使って、次の操作を実行できます。

• Open メソッドを使って、Record または URL から Stream を開きます。
  
  
• Close メソッドを使って、Stream を閉じます。
  
  
• Write メソッドまたは WriteText メソッドを使って、バイトまたはテキストを Stream に入力します。
  
  
• Read メソッドまたは ReadText メソッドを使って、Stream からバイトを読み取ります。
  
  
• Flush メソッドを使って、基になるオブジェクトに ADO バッファにある Stream データを書き込みます。
  
  
• CopyTo メソッドを使って、Stream の内容を別の Stream にコピーします。
  
  
• SkipLine メソッドおよび LineSeparator プロパティを使って、ソース ファイルから行を読み取る方法を制御します。
  
  
• EOS プロパティおよび SetEOS メソッドを使って、ストリーム位置の末尾を判別または設定します。
  
  
• SaveToFile メソッドおよび LoadFromFile メソッドを使って、ファイル内のデータを保存および復元します。
  
  
• Charset プロパティを使って、Stream の保存に使う文字セットを指定します。
  
  
• Cancel メソッドを使って、非同期 Stream の実行を停止します。
  
  
• Size プロパティを使って、Stream 内のバイト数を数えます。
  
  
• Position プロパティを使って、Stream 内の現在の位置を制御します。
  
  
• Type プロパティを使って、Stream 内のデータ型を判別します。
  
  
• State プロパティを使って、Stream の現在の状態 (開いている、閉じている、または実行中) を判別します。
  
  
• Mode プロパティを使って、Stream のアクセス モードを指定します。