适用于:Access 2013、Office 2013
用于将 Stream 中指定数量的字符或字节(取决于类型)复制到另一个 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 对象中。