Open 方法(ADO 流)

打开 Stream 对象,用于操作二进制数据或文本数据流

语法

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

参数

Source
可选。 Variant 值,用于指定 Stream 的数据源。 Source 可能包含绝对 URL 字符串,该字符串指向常见树结构中的现有节点,例如电子邮件或文件系统。 应使用 URL 关键字(“URL=scheme://server/folder”)指定 URL。 另外,Source 可能包含对已打开的 Record 对象的引用,该对象打开与 Record 关联的默认流。 如果未指定 Source,则实例化并打开 Stream,并默认不将其与底层源关联。 有关 URL 方案及其相关提供程序的详细信息,请参阅绝对 URL 和相对 URL

模式
可选。 ConnectModeEnum 值,用于指定结果 Stream 的访问模式(例如读/写或只读)。 默认值为 adModeUnknown。 有关访问模式的详细信息,请参阅 Mode 属性。 如果未指定 Mode,则它由源对象继承。 例如,如果源 Record 在只读模式下打开,则 Stream 也默认在只读模式下打开。

OpenOptions
可选。 StreamOpenOptionsEnum 值。 默认值为 adOpenStreamUnspecified。

UserName
可选。 String 值,该值包含用于在需要时访问 Stream 对象的用户标识。

密码
可选。 String 值,该值包含用于在需要时访问 Stream 对象的密码。

注解

将 Record 对象作为源参数传入时,不会使用 UserID 和 Password 参数,因为已经可以访问 Record 对象。 同样,Record 对象的 Mode 传输到 Stream 对象。 如果未指定 Source,则打开的 Stream 不包含任何数据且 Size 为零 (0)。 为避免在关闭 Stream 时丢失写入此 Stream 的任何数据,请使用 CopyToSaveToFile 方法保存 Stream,或将其保存到其他内存位置。

adOpenStreamFromRecord 的 OpenOptions 值将 Source 参数的内容标识为已打开的 Record 对象。 默认行为是将 Source 视为直接指向树结构中的节点(例如文件)的 URL。 打开与该节点关联的默认流。

在 Stream 未打开时,可以读取 Stream 的所有只读属性。 如果以异步方式打开 Stream,则所有后续操作(检查 State 和其他只读属性除外)都会受阻,直到 Open 操作完成。

除了上述选项以外,通过不指定 Source,还可以在内存中创建 Stream 对象的实例,且无需将其与底层源相关联。 可以通过使用 WriteWriteText 将二进制数据或文本数据写入 Stream,或通过使用 LoadFromFile 从文件加载数据来动态地将数据添加到流。

应用于

流对象 (ADO)

另请参阅

Open 方法(ADO 连接)
Open 方法(ADO 记录)
Open 方法(ADO 记录集)
OpenSchema 方法
SaveToFile 方法