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 对象的文本中。