MoveRecord 方法 (ADO)
将 记录 表示的实体移动到另一个位置。
语法
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
参数
源
自选。 一个 字符串 值,该值包含标识要移动的 记录 的 URL。 如果省略 源 或指定空字符串,则移动此 Record 所表示的对象。 例如,如果 记录 表示文件,则文件的内容将移动到 目标指定的位置。
目标
自选。 一个 字符串 值,该值包含指定将移动源 位置的 URL。
UserName
自选。 一个 字符串 值,该值包含用户 ID(如果需要)授权访问 目标。
密码
自选。 包含密码的 字符串,如果需要,请验证 UserName。
选项
自选。
MoveRecordOptionsEnum 值,其默认值 adMoveUnspecified。 指定此方法的行为。
异步
自选。
布尔 值,当 True时,指定此操作应为异步操作。
返回值
字符串 值。 通常,返回 目标 的值。 但是,返回的确切值取决于提供程序。
言论
源 和 目标 的值不得相同;否则,将发生运行时错误。 至少服务器、路径和资源名称必须不同。
对于使用 Internet 发布提供程序移动的文件,此方法将更新要移动的文件中的所有超文本链接,除非 选项另有指定。 如果 目标 标识现有对象(例如文件或目录),则此方法将失败,除非指定 adMoveOverWrite。
注意
谨慎使用 adMoveOverWrite 选项。 例如,将文件移动到目录时指定此选项将删除目录并将其替换为该文件。
Record 对象的某些属性(如 ParentURL 属性)在此操作完成后不会更新。 通过关闭 记录来刷新 记录 对象的属性,然后使用文件或目录移动位置的 URL 重新打开它。
如果从 Recordset获取此 记录,则移动文件或目录的新位置将不会立即反映在 Recordset中。 通过关闭并重新打开记录集来刷新 记录集。
注意
使用 http 方案的 URL 将自动调用 Microsoft OLE DB Provider for Internet Publishing。 有关详细信息,请参阅 绝对 URL 和相对 URL。
适用于
另请参阅
Move 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (RDS)