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

适用于

记录对象 (ADO)