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