ADODB.Stream 对象详解.doc

ADODB.Stream 对象详解 ADODB.Stream 对象详解 减小字体 增大字体 Stream 对象 表示二进制数据或文本的流。 说明 在诸如文件系统或电子邮件系统这样的树状分级结构中，Record 可能有一个与之相关联的位的默认二进制流，其中包含文件或电子邮件的内容。Stream 对象可用于对包含这些数据流的字段或记录进行操作。可以通过下列方式获取 Stream 对象： 通过指向包含二进制或文本数据的对象（通常是文件）的 URL。此对象可以是简单的文档、表示结构化文档的 Record 对象或文件夹。 通过打开与 Record 对象相关联的默认 Stream 对象。打开 Record 时便可获取与 Record 对象相关联的默认流。只需打开该流便可删除一个往返过程。 通过将 Stream 对象实例化。这些 Stream 对象可用来存储用于应用程序的数据。跟与 URL 相关联的 Stream 或 Record 的默认 Stream 不同，实例化的 Stream 在默认情况下与基本源没有关联。 用 Stream 对象的方法和属性可以执行下列操作： 用 Open 方法从 Record 或 URL 打开 Stream 对象。 用 Close 方法关闭 Stream。 用 Write 和 WriteText 方法向 Stream 中输入字节或文本。 用 Read 和 ReadText 方法从 Stream 中读取字节。 用 Flush 方法将仍在 ADO 缓冲区中的任何 Stream 数据写入基本对象。 用 CopyTo 方法将 Stream 的内容复制到另一 Stream。 用 SkipLine 方法和 LineSeparator 属性控制从源文件中读取行的方式。 用 EOS 属性和 SetEOS 方法确定流位置的结尾。 用 SaveToFile 和 LoadFromFile 方法保存和恢复文件中的数据。 用 Charset 属性指定用于存储 Stream 的字符集。 用 Cancel 方法终止异步 Stream 操作。 用 Size 属性确定 Stream 中的字节数。 用 Position 属性控制 Stream 中的当前位置。 用 Type 属性确定 Stream 中的数据类型。 用 State 属性确定 Stream 的当前状态（已打开、关闭或正在执行）。 用 Mode 属性指定 Stream 的访问模式。 Open 方法 ADO Stream 打开 Stream 对象来操作二进制或文本数据的流。 语法 Stream.Open Source, Mode, OpenOptions, UserName, Password 参数 Source 可选。Variant 值，指定 Stream 的数据源。Source 可能包含绝对 URL 字符串，该字符串指向某个众所周知的树状结构（如电子邮件或文件系统）中现有的节点。应使用 URL 关键字（“URL http://server/folder”）来指定 URL。另外，Source 也可包含对已打开的 Record 对象的引用，该对象打开与 Record 相关联的默认流。如果未指定 Source，Stream 将被实例化并被打开，默认情况下它不与基本源相关联。 Mode 可选。ConnectModeEnum 值，指定得出的 Stream 的访问模式（例如，读/写或只读）。默认值为 adModeUnknown。有关访问模式的详细信息，请参阅 Mode 属性。如果未指定 Mode，它将被源对象继承。例如，如果以只读模式打开源 Record，那么默认情况下 Stream 也将以只读模式打开。 OpenOptions 可选。StreamOpenOptionsEnum 值。默认值为 adOpenStreamUnspecified。 UserName 可选。String 值，包含（在需要时）访问 Stream 对象的用户标识。 Password 可选。String 值，包含（在需要时）访问 Stream 对象的密码。 说明 当把 Record 对象作为源参数传递时，将不使用 UserID 和 Password 参数，因为这样就已经可以访问 Record 对象。与之类似，Record 对象的 Mode 也被传递给 Stream 对象。 如果未指定 Source，打开的 Stream 将不包含数据，并且其 Size 为零 0 。当 Stream 关闭时，要避免丢失任何写入此 Stream 的数据，请用 CopyTo 或 SaveToFile 方法保存 Stream，或将其保存到另一个内存位置。 Stream 未打开时，有