CopyRecord 方法 (ADO)
将由 记录表示的实体复制到另一个位置。
语法
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)
参数
源
自选。 一个 字符串 值,该值包含指定要复制的实体的 URL(例如,文件或目录)。 如果省略 源 或指定空字符串,则将复制由当前 记录 表示的文件或目录。
目标
自选。 一个 字符串 值,该值包含指定将复制源 位置的 URL。
UserName
自选。 一个 字符串 值,该值包含用户 ID(如果需要)授权访问 目标。
密码
自选。 一个 字符串 值,该值包含密码(如果需要)验证 UserName。
选项
自选。
CopyRecordOptionsEnum 值,其默认值 为 adCopyUnspecified。 指定此方法的行为。
异步
自选。
True时,布尔 值指定此操作应为异步操作。
返回值
通常返回目标 值的 字符串 值。 但是,返回的确切值取决于提供程序。
言论
源 和 目标 的值不得相同;否则,将发生运行时错误。 至少有一个服务器、路径或资源名称必须不同。
除非指定了 adCopyNonRecursive,否则以递归方式复制 源 的所有子目录(例如子目录)。 在递归操作中,目标 不能是 源的子目录;否则,该操作将不完成。
如果 目标 标识现有实体(例如文件或目录),除非指定 了 adCopyOverWrite,否则此方法将失败。
重要
adCopyOverWrite 选项谨慎使用。 例如,将文件复制到目录时指定此选项 删除 目录并将其替换为该文件。
注意
使用 http 方案的 URL 将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL。