Stream オブジェクト (ADO)Stream Object (ADO)

バイナリデータまたはテキストのストリームを表します。Represents a stream of binary data or text.

ファイルシステムや電子メールシステムなどのツリー構造の階層では、レコードには、ファイルまたは電子メールの内容を含む既定のバイナリストリームが関連付けられている場合があります。In tree-structured hierarchies such as a file system or an e-mail system, a Record may have a default binary stream of bits associated with it that contains the contents of the file or the e-mail. ストリームオブジェクトは、これらのデータストリームを含むフィールドまたはレコードを操作するために使用できます。A Stream object can be used to manipulate fields or records containing these streams of data. ストリームオブジェクトは、次の方法で取得できます。A Stream object can be obtained in these ways:

  • バイナリまたはテキストデータを含むオブジェクト (通常はファイル) を指す URL。From a URL pointing to an object (typically a file) containing binary or text data. このオブジェクトには、単純なドキュメント、構造化されたドキュメントを表すレコードオブジェクト、またはフォルダーを指定できます。This object can be a simple document, a Record object representing a structured document, or a folder.

  • Recordオブジェクトに関連付けられた既定のストリームオブジェクトを開く。By opening the default Stream object associated with a Record object. レコードを開いたときにレコードオブジェクトに関連付けられた既定のストリームを取得して、ストリームを開くだけでラウンドトリップが行われないようにすることができます。You can obtain the default stream associated with a Record object when the Record is opened, to eliminate a round-trip just to open the stream.

  • ストリームオブジェクトをインスタンス化する。By instantiating a Stream object. これらのストリームオブジェクトは、アプリケーションの目的でデータを格納するために使用できます。These Stream objects can be used to store data for the purposes of your application. URL に関連付けられたストリームレコードの既定のストリームとは異なり、インスタンス化されたストリームには、既定で基になるソースとの関連付けがありません。Unlike a Stream associated with a URL, or the default Stream of a Record, an instantiated Stream has no association with an underlying source by default.

Streamオブジェクトのメソッドとプロパティを使用して、次の操作を実行できます。With the methods and properties of a Stream object, you can do the following:

  • Openメソッドを使用して、レコードまたは URL からストリームオブジェクトを開きます。Open a Stream object from a Record or URL with the Open method.

  • Closeメソッドを使用してストリームを閉じます。Close a Stream with the Close method.

  • WriteおよびWriteTextメソッドを使用してストリームにバイトまたはテキストを入力します。Input bytes or text to a Stream with the Write and WriteText methods.

  • ReadおよびReadTextメソッドを使用して、ストリームからバイトを読み取ります。Read bytes from the Stream with the Read and ReadText methods.

  • ADO バッファーに残っているストリームデータを、 Flushメソッドを使用して基になるオブジェクトに書き込みます。Write any Stream data still in the ADO buffer to the underlying object with the Flush method.

  • CopyToメソッドを使用してストリームの内容を別のストリームにコピーします。Copy the contents of a Stream to another Stream with the CopyTo method.

  • SkipLineメソッドとlineseparatorプロパティを使用して、ソースファイルから行を読み取る方法を制御します。Control how lines are read from the source file with the SkipLinemethod and the LineSeparator property.

  • EOSプロパティとSetEOSメソッドを使用して、ストリームの位置の終わりを確認します。Determine the end of stream position with the EOSproperty and SetEOS method.

  • SaveToFileメソッドとLoadFromFileメソッドを使用して、データをファイルに保存して復元します。Save and restore data in files with the SaveToFileand LoadFromFile methods.

  • Charsetプロパティを使用して、ストリームの格納に使用する文字セットを指定します。Specify the character set used for storing the Stream with the Charset property.

  • Cancelメソッドを使用して、非同期ストリーム操作を停止します。Halt an asynchronous Stream operation with the Cancel method.

  • Sizeプロパティを使用して、ストリーム内のバイト数を決定します。Determine the number of bytes in a Stream with the Size property.

  • Positionプロパティを使用して、ストリーム内の現在位置を制御します。Control the current position within a Stream with the Position property.

  • Typeプロパティを使用して、ストリーム内のデータの種類を決定します。Determine the type of data in a Stream with the Type property.

  • Stateプロパティを使用して、ストリームの現在の状態 (閉じている、開いている、または実行中) を確認します。Determine the current state of the Stream (closed, open, or executing) with the State property.

  • モードプロパティを使用して、ストリームのアクセスモードを指定します。Specify the access mode for the Stream with the Mode property.

注意

Http スキームを使用する Url は、インターネット公開のために Microsoft OLE DB プロバイダーを自動的に呼び出します。URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. 詳細については、「絶対 url と相対 url」を参照してください。For more information, see Absolute and Relative URLs.

ストリームオブジェクトは、スクリプトに対して安全です。The Stream object is safe for scripting.

このセクションでは、次のトピックを扱います。This section contains the following topics.

参照See Also

レコードとストリームRecords and Streams