《VBStream对象使用详细的介绍》由会员分享，可在线阅读，更多相关《VBStream对象使用详细的介绍（11页珍藏版）》请在金锄头文库上搜索。
1、word格式在诸如文件系统或电子邮件系统这样的树状分级结构中，Record 可能有一个与之相关联的位的默认二进制流，其中包含文件或电子邮件的内容。Stream 对象可用于对包含这些数据流的字段或记录进行操作。可以通过下列方式获取 Stream 对象：通过指向包含二进制或文本数据的对象（通常是文件）的 URL。此对象可以是简单的文档、表示结构化文档的 Record 对象或文件夹。通过打开与 Record 对象相关联的默认 Stream 对象。打开 Record 时便可获取与 Record 对象相关联的默认流。只需打开该流便可删除一个往返过程。通过将 Stream 对象实例化。这些 Stream
2、对象可用来存储用于应用程序的数据。跟与 URL 相关联的 Stream 或 Record 的默认 Stream 不同，实例化的 Stream 在默认情况下与基本源没有关联。 用 Stream 对象的方法和属性可以执行下列操作：用 Open 方法从 Record 或 URL 打开 Stream 对象。用 Close 方法关闭 Stream。用 Write 和 WriteText 方法向 Stream 中输入字节或文本。用 Read 和 ReadText 方法从 Stream 中读取字节用 Flush 方法将仍在 ADO 缓冲区中的任何 Stream 数据写入基本对象。用 CopyTo 方法将 S
3、tream 的内容复制到另一 Stream。用 SkipLine 方法和 LineSeparator 属性控制从源文件中读取行的方式。用 EOS 属性和 SetEOS 方法确定流位置的结尾。用 SaveToFile 和 LoadFromFile 方法保存和恢复文件中的数据。用 Charset 属性指定用于存储 Stream 的字符集。用 Cancel 方法终止异步 Stream 操作。用 Size 属性确定 Stream 中的字节数。用 Position 属性控制 Stream 中的当前位置。用 Type 属性确定 Stream 中的数据类型。用 State 属性确定 Stream 的当前状态
4、（已打开、关闭或正在执行）。用 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 也可包含对
5、已打开的 Record 对象的引用，该对象打开与 Record 相关联的默认流。如果未指定 Source，Stream 将被实例化并被打开，默认情况下它不与基本源相关联。Mode 可选。ConnectModeEnum 值，指定得出的 Stream 的访问模式（例如，读/写或只读）。默认值为 adModeUnknown。有关访问模式的详细信息，请参阅 Mode 属性。如果未指定 Mode，它将被源对象继承。例如，如果以只读模式打开源 Record，那么默认情况下 Stream 也将以只读模式打开。OpenOptions 可选。StreamOpenOptionsEnum 值。默认值为 adOpen
6、StreamUnspecified。UserName 可选。String 值，包含（在需要时）访问 Stream 对象的用户标识。Password 可选。String 值，包含（在需要时）访问 Stream 对象的密码。说明当把 Record 对象作为源参数传递时，将不使用 UserID 和 Password 参数，因为这样就已经可以访问 Record 对象。与之类似，Record 对象的 Mode 也被传递给 Stream 对象。如果未指定 Source，打开的 Stream 将不包含数据，并且其 Size 为零 (0)。当 Stream 关闭时，要避免丢失任何写入此 Stream 的数据，
7、请用 CopyTo 或 SaveToFile 方法保存 Stream，或将其保存到另一个内存位置。Stream 未打开时，有可能读取 Stream 的所有只读属性。如果异步打开 Stream，所有后续的操作（除了检查 State 和其他只读属性）都将被阻塞，直到 Open 操作完成为止。Close 方法关闭打开的对象和任何相关的对象。语法object.Close说明使用 Close 方法关闭 Connection、Record、Recordset 或 Stream 对象以便释放任何相关联的系统资源。关闭对象不会将其从内存中删除；随后可以更改其属性设置并再次将其打开。要从内存中彻底清除对象，请在
8、关闭对象后将对象变量设置为 Nothing（在 Visual Basic 中）。Connection使用 Close 方法关闭 Connection 对象还将关闭与连接相关联的任何活动 Recordset 对象。与正在关闭的 Connection 对象相关联的 Command 对象将被持久保留，但不再与 Connection 对象相关联，即其 ActiveConnection 属性将被设置为 Nothing。还将从 Command 对象的 Parameters 集合中清除任何提供者定义的参数。随后可以调用 Open 方法重新建立与相同数据源或其他数据源的连接。在 Connection 对象关闭
9、后，调用任何需要与数据源打开连接的方法都将产生错误。当连接上的 Recordset 对象打开时，关闭 Connection 对象将回卷所有 Recordset 对象中的挂起更改。在事务进行过程中显式关闭 Connection 对象（调用 Close 方法）将产生错误。如果在事务进行过程中 Connection 对象超出范围，ADO 将自动回卷事务。Recordset、Record 和 Stream使用 Close 方法关闭 Recordset、Record 或 Stream 对象将释放相关联的数据和可能通过此特定对象对数据进行的独立访问。随后可以调用 Open 方法重新打开具有相同属性或修改属
10、性的对象。在 Recordset 对象关闭后，调用任何需要活动游标的方法都将产生错误。如果在立即更新模式下进行编辑，调用 Close 方法将产生错误，应先调用 Update 或 CancelUpdate 方法。如果在批更新模式下关闭 Recordset 对象，自上次 UpdateBatch 调用以来所做的更改将全部丢失。如果使用 Clone 方法创建打开的 Recordset 对象的副本，关闭原 Recordset 或其副本不会影响任何其他副本。Write 方法将二进制数据写入 Stream 对象。语法Stream.Write Buffer参数Buffer Variant，包含要写入的字节数组
11、。说明指定的字节被写入 Stream 对象，每个字节之间没有间隔。当前 Position 被设置为写入数据的后一个字节。Write 方法不会截断流中剩余的数据。如果要截断这些字节，请调用 SetEOS。如果写入超过了当前 EOS 位置，Stream 的 Size 将增加以包含新的字节，EOS 也将移动到 Stream 中新的最后一个字节。WriteText 方法将指定的文本字符串写入 Stream 对象。语法Stream.WriteText Data, Options参数Data String 值，包含要写入的字符文本。Options 可选。StreamWriteEnum 值，指定是否在指定字
12、符串的结尾写入分行符字符。说明指定的字符串被写入 Stream 对象，每个字符串之间没有间隔空格或字符。当前 Position 被设置为写入数据的后一个字节。WriteText 方法不会截断流中剩余的数据。如果要截断这些字节，请调用 SetEOS。如果写入超过了当前 EOS 位置，Stream 的 Size 将增加以包含新的字符，EOS 也将移动到 Stream 中新的最后一个字节。Read 方法从二进制 Stream 对象读取指定的字节数。语法Variant = Stream.Read ( NumBytes )参数NumBytes 可选。Long 值，指定要从文件或 StreamReadEn
13、um 值 adReadAll（默认值）读取的字节数。返回值Read 方法从 Stream 对象读取指定的字节数或整个流，并以 Variant 形式返回所得到的数据。说明如果 NumBytes 超过 Stream 中剩余的字节数，将只返回剩余的字节。数据读取没有被填充到与 NumBytes 指定的长度一致。如果没有剩余的字节可读取，将返回一个值为 Null 的变体。Read 不能用于向后读取。注意 NumBytes 始终度量字节。对于文本 Stream 对象，请使用 ReadText。ReadText 方法从文本 Stream 对象读取指定数目的字符。语法String = Stream.Read
14、Text ( NumChars )参数NumChars 可选。Long 值，指定要从文件读取的字符数，或 StreamReadEnum 值。默认值为 adReadAll。返回值ReadText 方法从 Stream 对象中读取指定数目的字符、整个行或整个流，并返回所得到的字符串。说明如果 NumChar 超过流中剩余的字符数，将只返回剩余的字符。读取的字符串没有被填充到与 NumChar 指定的长度一致。如果没有剩余的字符可读取，将返回一个值为 Null 的变体。ReadText 不能用于向后读取。ReadText 方法与文本流（Type 为 adTypeText）一起使用。对于二进制流，请使
15、用 Read。Flush 方法将保留在 ADO 缓冲区中的 Stream 的内容强加到与 Stream 相关联的基本对象。语法Stream.Flush说明此方法可用于将流缓冲区的内容发送到 URL（Stream 对象源）表示的基本对象。要确保对 Stream 内容所做的所有更改都被写入，应调用此方法。但是使用 ADO 时一般不必调用 Flush，因为 ADO 尽可能在后台不断刷新其缓冲区。Stream 内容的更改将自动进行，在调用 Flush 前不会被缓存。用 Close 方法关闭 Stream 将自动刷新 Stream 的内容，而无需在 Close 之前显式地调用 Flush。CopyTo 方法将 Stream 中指定数目的字符或字节（取决于 Type）复制到另一个 Stream 对象。语法Stream.CopyTo DestStream, NumChars参数DestStre
