CopyTo 方法 (ADO)

  • 项目

将 Stream 中指定数量的字符或字节（取决于 Type）复制到另一个 Stream 对象。

语法

  
Stream.CopyTo DestStream, NumChars

参数

DestStream
一个对象变量值，该值包含对打开的 Stream 对象的引用。 当前 Stream 将复制到 DestStream 指定的目标 Stream。 目标 Stream 必须已打开。 否则，将发生运行时错误。

注意

DestStream 参数可能不是 Stream 对象的代理，因为这需要访问 Stream 对象上的专用接口，该对象无法远程访问客户端。

NumChars
可选。 一个“整数”值，指定要从源 Stream 中的当前位置复制到目标 Stream 的字节数或字符数。 默认值为 -1，表示将所有字符或字节从当前位置复制到 EOS。

备注

此方法从 Position 属性指定的当前位置开始复制指定的字符数或字节数。 如果指定的数目大于 EOS 之前的可用字节数，则仅复制从当前位置到 EOS 的字符或字节。 如果 NumChars 的值为 -1 或已省略，则复制从当前位置开始的所有字符或字节。

如果目标流中存在现有字符或字节，则复制结束点以外的所有内容都将保留，并且不会被截断。 Position 将成为紧随上次复制字节之后的字节。 如果要截断这些字节，请调用 SetEOS。

CopyTo 应用于将数据复制到与源 Stream 类型相同的目标 Stream（它们的 Type 属性设置均为 adTypeText 或 adTypeBinary）。 对于文本 Stream 对象，可以更改目标 Stream 的 Charset 属性设置，以便从一个字符集转换为另一个字符集。 此外，文本 Stream 对象可以成功复制到二进制 Stream 对象中，但二进制 Stream 对象不能复制到文本 Stream 对象中。

应用于

流对象 (ADO)