MoveRecord 方法 (ADO)

将由 Record 表示的实体移动到另一个位置。

语法

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

参数

Source
可选。 字符串型值，其中包含标识要移动的 Record 的 URL。 如果忽略 Source 或者指定一个空字符串，将移动由该 Record 表示的对象。 例如，如果 Record 代表文件，则将文件的内容移动到由 Destination 指定的位置。

目标
可选。 字符串型值，包含用于指定 Source 将移动到的位置的 URL。

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

密码
可选。 包含密码的字符串型，如果需要，将验证 UserName。

选项
可选。 MoveRecordOptionsEnum 值，其默认值为 adMoveUnspecified。 指定此方法的行为。

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

返回值

一个字符串值。 通常返回 Destination 值。 但是，返回的确切值取决于提供程序。

备注

Source 和 Destination 的值不能相同；否则，将发生运行时错误。 至少服务器、路径和资源名必须不同。

对于使用 Internet 发布提供程序移动的文件，该方法更新被移动文件中的所有超文本链接，除非 Options 另有指定。 如果 Destination 标识现有的对象（如文件或目录），该方法将失败，除非指定 adMoveOverWrite。

注意

谨慎使用 adMoveOverWrite 选项。 例如，在将文件移动到目录时指定此选项将删除该目录并将其替换为文件。

Record 对象的某些属性（如 ParentURL 属性）在该操作完成后不会更新。 可以通过以下方法来刷新 Record 对象的属性：关闭 Record，然后使用文件或目录移动到的位置的 URL 重新将其打开。

如果此 Record 从 Recordset 获取，则移动的文件或目录的新位置不会立即反映到 Recordset 中。 可以刷新 Recordset，方法是关闭再重新打开。

注意

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

应用于

记录对象 (ADO)

另请参阅

Move 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (RDS)