MoveRecord 方法 (ADO)
适用于:Access 2013、Office 2013
用于将由 Record 表示的实体移动到其他位置。
语法
记录。MoveRecord (源、 目标、 用户名、 密码、 选项、 异步)
参数
参数 | 说明 |
---|---|
Source | 可选。 字符串型值,包含标识要移动的 Record 的 URL。 如果忽略 Source 或者指定一个空字符串,将删除由该 Record 表示的对象。 例如,如果 Record 代表文件,则将文件的内容移动到由 Destination 指定的位置。 |
目标 | 可选。 字符串型值,包含用于指定 Source 将移动到的位置的 URL。 |
UserName | 可选。 包含用户 ID 的字符串型值,如果需要,将授予访问 Destination 的权限。 |
Password | 可选。 包含密码的字符串型值,如果需要,将通过该密码验证 UserName。 |
选项 | 可选。 MoveRecordOptionsEnum 值,其默认值为 adMoveUnspecified。 指定该方法的行为。 |
Async | 可选。 一个 布尔 值,如果 为 True,则指定此操作应为异步操作。 |
返回值
字符串型值。 通常返回 Destination 的值。 但是,返回的确切值与提供程序有关。
备注
Source 和 Destination 的值不能相同;否则,将发生运行时错误。 至少服务器、路径和资源名必须不同。
对于使用 Internet Publishing Provider 移动的文件,该方法更新被移动文件中的所有超文本链接,除非 Options 另有指定。 如果 Destination 标识现有的对象(如文件或目录),该方法将失败,除非指定 adMoveOverWrite。
注意
[!注释] 应谨慎使用 adMoveOverWrite 选项。 例如,在将文件移动到目录时指定此选项将删除该目录并替换为复制的文件。
Record 对象的某些属性(如 ParentURL 属性)在该操作完成后不会更新。 可以通过以下方法来刷新 Record 对象的属性:关闭 Record ,然后使用文件或目录移动到的位置的 URL 重新打开该记录。
如果此 Record 是从 Recordset 获取的,则移动的文件或目录的新位置将不会立即反映到 Recordset 中。 您可以刷新 Recordset ,方法是关闭并重新打开它。
注意
[!注释] 使用 HTTP 架构的 URL 将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL。