CopyTo 方法 (ADO)

Stream 中的指定字符数或字节数(具体取决于 类型)复制到另一个 Stream 对象。

语法

  
Stream.CopyTo DestStream, NumChars  

参数

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

注意

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

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

言论

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

如果目标流中存在现有字符或字节,则复制结束的点以外的所有内容都不会被截断。 位置 紧跟在复制最后一个字节之后的字节。 如果要截断这些字节,请调用 SetEOS

CopyTo 应用于将数据复制到与源 Stream 相同的类型的目标 Stream(其 Type 属性设置既 adTypeText,要么 adTypeBinary)。 对于文本 Stream 对象,可以更改目标 Stream属性设置的 Charset 属性设置,以便从一个字符集转换为另一个字符集。 此外,可以将流 对象的文本 成功复制到二进制 Stream 对象中,但无法将二进制 Stream 对象复制到 Stream 对象的文本中。

适用于

Stream 对象 (ADO)