ADO Streamオブジェクト
Stream オブジェクト(ADO バージョン 2.5)
ADO Stream オブジェクトは、バイナリデータまたはテキストストリームの読み書きおよび処理に使用されます。
Stream オブジェクトは、次の3つの方法で取得できます:
- バイナリまたはテキストデータを含むオブジェクト(通常はファイル)を指す URL を介して取得します。このオブジェクトは、単純なドキュメント、構造化ドキュメントを表す Record オブジェクト、またはフォルダにすることができます。
- Stream オブジェクトをインスタンス化する方法です。これらの Stream オブジェクトは、アプリケーション用のデータを格納するために使用できます。URL に関連付けられた Stream や Record のデフォルトの Stream とは異なり、インスタンス化された Stream は、デフォルトでは基本ソースに関連付けられていません。
- Record オブジェクトに関連付けられたデフォルトの Stream オブジェクトを開く方法です。Record を開くと、Record オブジェクトに関連付けられたデフォルトのストリームを取得できます。そのストリームを開くだけで、ラウンドトリップ(往復処理)を1回削除できます。
構文
objectname.property
objectname.method
objectname.method
プロパティ
| プロパティ | 説明 |
|---|---|
| CharSet | Stream の保存に使用する文字セットを指定します。 |
| EOS | 現在位置がストリームの末尾にあるかどうかを返します。 |
| LineSeparator | テキスト Stream オブジェクトで使用する改行文字を設定または返します。 |
| Mode | データを変更するために使用できる権限を設定または返します。 |
| Position | Stream オブジェクトの先頭からの現在位置(バイト単位)を設定または返します。 |
| Size | 開いている Stream オブジェクトのサイズを返します。 |
| State | Stream が開いているか閉じているかを示す値を返します。 |
| Type | Stream オブジェクト内のデータのタイプを設定または返します。 |
メソッド
| メソッド | 説明 |
|---|---|
| Cancel | Stream オブジェクトの Open 呼び出しの実行をキャンセルします。 |
| Close | Stream オブジェクトを閉じます。 |
| CopyTo | 指定した数の文字/ビットを、ある Stream オブジェクトから別の Stream オブジェクトにコピーします。 |
| Flush | Stream バッファ内のコンテンツを、関連付けられた基になるオブジェクトに送信します。 |
| LoadFromFile | ファイルのコンテンツを Stream オブジェクトに読み込みます。 |
| Open | Stream オブジェクトを開きます。 |
| Read | バイナリ Stream オブジェクトから、全体のストリームまたは指定したバイト数を読み取ります。 |
| ReadText | テキスト Stream オブジェクトから、全体のストリーム、1行、または指定したバイト数を読み取ります。 |
| SaveToFile | Stream オブジェクトのバイナリコンテンツをファイルに保存します。 |
| SetEOS | 現在位置をストリームの末尾(EOS)に設定します。 |
| SkipLine | テキストストリームを読み取るときに1行スキップします。 |
| Write | バイナリデータをバイナリ Stream オブジェクトに書き込みます。 |
| WriteText | 文字データをテキスト Stream オブジェクトに書き込みます。 |