CopyRecord 方法 (ADO)

将由 Record 表示的实体复制到另一个位置。

语法

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)  

参数

Source
可选。 一个 String 值,包含一个 URL,指定要复制的实体(例如文件或目录)。 如果省略 Source 或指定空字符串,则将复制由当前 Record 表示的文件或目录。

目标
可选。 String 值,包含用于指定 Source 将复制到的位置的 URL。

UserName
可选。 包含用户 ID 的字符串型值,如果需要,将授予访问 Destination 的权限。

密码
可选。 包含密码的 String 值,如果需要,将验证 UserName。

选项
可选。 CopyRecordOptionsEnum 值,默认为 adCopyUnspecified。 指定此方法的行为。

异步
可选。 一个布尔值,当为 True 时,指定此操作应为异步操作。

返回值

通常返回 Destination 值的 String 值。 但是,返回的确切值取决于提供程序。

备注

Source 和 Destination 的值不能相同;否则,将发生运行时错误。 至少有一个服务器名、路径名或资源名是不同的。

除非指定 adCopyNonRecursive,否则 Source 的所有子级(例如子目录)都将以递归方式复制。 在递归操作中,Destination 不能是 Source 的子目录;否则,该操作将无法完成。

如果 Destination 标识现有的实体(如文件或目录),该方法将失败,除非指定 adCopyOverWrite。

重要

请谨慎使用 adCopyOverWrite 选项。 例如,在将文件复制到目录时指定此选项将删除该目录并会将其替换为文件。

注意

使用 http 方案的 URL 将自动调用用于 Internet 发布的 Microsoft OLE DB 提供程序。 有关详细信息,请参阅绝对 URL 和相对 URL

应用于

记录对象 (ADO)