Open メソッド (ADO Stream)

適用先: Access 2013、Office 2013

バイナリ データまたはテキスト データのストリームを操作するために Stream オブジェクトを開きます。

構文

Stream。 オープン ソース、モード、OpenOptions、UserName、Password

パラメーター

パラメーター	説明
Source	省略可能です。 Streamのデータソースを指定する Variant 値。 ソース には、電子メールやファイル システムなど、既知のツリー構造内の既存のノードを指す絶対 URL 文字列が含まれている場合があります。 URL は、URL キーワード (keyword) ("URL=scheme://server/folder") を使用して指定する必要があります。 または、 Source に既に開いている Record オブジェクトへの参照を含め、 Record に関連付けられている既定のストリームを開きます。 Source が指定されていない場合、Streamがインスタンス化されて開き、基になるソースに既定で関連付けられます。 URL スキームとその関連プロバイダーの詳細については、「 絶対 URL と相対 URL」を参照してください。
Mode	省略可能です。 結果の Stream に対するアクセス モード (読み取り/書き込み、読み取り専用など) を ConnectModeEnum 値で指定します。 既定値は adModeUnknown です。 アクセス モードの詳細については、「Mode プロパティ (ADO)」を参照してください。 Mode を指定しない場合は、ソース オブジェクトから継承されます。 たとえば、ソース Record が読み取り専用モードで開かれている場合、既定では、その Stream も読み取り専用モードで開かれます。
OpenOptions	省略可能です。 StreamOpenOptionsEnum 値を指定します。 既定値は adOpenStreamUnspecified です。
UserName	省略可能です。 必要に応じて、 Stream オブジェクトにアクセスするためのユーザー ID を含む、文字列型 ( String ) の値を指定します。
Password	省略可能です。 必要に応じて、Stream オブジェクトにアクセスするためのパスワードを含む、文字列型 (String) の値を指定します。

注釈

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

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

Stream が開かれていないときは、 Stream の読み取り専用プロパティをすべて読み取ることができます。 Stream が非同期で開かれている場合、以降のすべての操作 ( State プロパティやその他の読み取り専用プロパティの確認を除く) は、 Open 操作が完了するまでブロックされます。

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