Open メソッド (ADO Stream)

Stream オブジェクトを開いて、バイナリ データまたはテキスト データのストリームを操作します。

構文

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

パラメーター

ソース
省略可能。 Stream のデータのソースを指定する バリアント型 の値です。 Source には、電子メールやファイル システムなど、既知のツリー構造の既存のノードを指す絶対 URL 文字列が含まれている場合があります。 URL は URL キーワード ("URL=scheme://server/folder") を使用して指定する必要があります。 また、Source には既に開いている Record オブジェクトへの参照が含まれており、それによって Record に関連付けられている既定のストリームが開かれる場合もあります。 Source が指定されていない場合、Stream はインスタンス化されて開かれます。この場合、既定では、基になるソースには関連付けられていません。 URL スキームとそれに関連するプロバイダーの詳細については、「絶対 URL と相対 URL」を参照してください。

モード
省略可能。 結果として得られる Stream のアクセス モード (読み取り/書き込み可能、読み取り専用など) を指定する ConnectModeEnum 値。 既定値は adModeUnknown です。 アクセス モードの詳細については Mode プロパティを参照してください。 Mode が指定されていない場合は、ソース オブジェクトによって継承されます。 たとえば、ソースの Record が読み取り専用モードで開かれている場合、Stream も既定で読み取り専用モードで開かれます。

OpenOptions
省略可能。 StreamOpenOptionsEnum 値。 既定値は adOpenStreamUnspecified です。

UserName
省略可能。 必要に応じて Stream オブジェクトにアクセスするユーザー ID を含む String 値。

パスワード
省略可能。 必要に応じて Stream オブジェクトにアクセスするパスワードを含む String 値。

注釈

Record オブジェクトがソース パラメーターとして渡されると、Record オブジェクトへのアクセスは既に使用可能であるため、UserID パラメーターと Password パラメーターは使用されません。 同様に、Record オブジェクトの Mode は Stream オブジェクトに転送されます。 Source が指定されていない場合、開いた Stream にはデータが含まれていないので Size は 0 です。 Stream が閉じられたときにこの Stream に書き込まれるデータが失われるのを防ぐには、CopyTo メソッドまたは SaveToFile メソッドを使用して Stream を保存するか、別のメモリの場所に保存します。

adOpenStreamFromRecord の OpenOptions の値は、Source パラメーターの内容を、既に開いている Record オブジェクトとして識別します。 既定の動作では、Source は、ファイルなど、ツリー構造のノードを直接指す URL として扱われます。 そのノードに関連付けられている既定のストリームが開かれます。

Stream が開いているわけではありませんが、Stream のすべての読み取り専用プロパティを読み取ることはできます。 Stream が非同期で開かれると、Open 操作が完了するまで、後続のすべての操作 (State とその他の読み取り専用プロパティのチェックを除く) がブロックされます。

前に説明したオプションに加えて、Source を指定しないことで、基になるソースに関連付けることなく、Stream オブジェクトのインスタンスをメモリ内に作成できます。 Stream に Write または WriteText を使用してバイナリ データまたはテキスト データを書き込むか、LoadFromFile を使用してファイルからデータを読み込むことで、ストリームにデータを動的に追加できます。

適用対象

Stream オブジェクト (ADO)

参照

Open メソッド (ADO Connection)
Open メソッド (ADO Record)
Open メソッド (ADO Recordset)
OpenSchema メソッド
SaveToFile メソッド