Método MoveRecord (ADO)

Mueve la entidad representada por un objeto Record a otra ubicación.

Sintaxis

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

Parámetros

Origen
Opcional. Valor de tipo String que contiene una dirección URL que identifica el objeto Record que se va a mover. Si Source se omite o se especifica una cadena vacía, se mueve el objeto representado por este objeto Record. Por ejemplo, si el registro representa un archivo, el contenido del archivo se mueve a la ubicación especificada en Destination.

Destino
Opcional. Valor de tipo String que contiene una dirección URL que especifica la ubicación donde se moverá Source.

UserName
Opcional. Valor de tipo String que contiene el identificador de usuario que, si es necesario, autoriza el acceso a Destination.

Contraseña
Opcional. String que contiene la contraseña que, si es necesario, comprueba UserName.

Opciones
Opcional. Valor de MoveRecordOptionsEnum cuyo valor predeterminado es adMoveUnspecified. Especifica el comportamiento de este método.

Async
Opcional. Valor booleano que, cuando es True, especifica que esta operación debe ser asincrónica.

Valor devuelto

Un valor String. Normalmente, se devuelve el valor de Destination. Sin embargo, el valor exacto devuelto depende del proveedor.

Comentarios

Los valores de Source y Destination no deben ser idénticos; de lo contrario, se produce un error en tiempo de ejecución. Al menos los nombres de servidor, ruta de acceso y recurso deben diferir.

En el caso de los archivos movidos mediante el proveedor de publicación de Internet, este método actualiza todos los vínculos de hipertexto de los archivos que se mueven a menos que se especifique lo contrario en Options. Este método produce un error si Destination identifica un objeto existente (por ejemplo, un archivo o directorio), a menos que se especifique adMoveOverWrite.

Nota

Use la opción adMoveOverWrite con criterio. Por ejemplo, si se especifica esta opción al mover un archivo a un directorio, se eliminará el directorio y se reemplazará por el archivo.

Algunos atributos del objeto Record, como la propiedad ParentURL, no se actualizarán una vez completada esta operación. Actualice las propiedades del objeto Record cerrando el objeto Record y vuelva a abrirlo con la dirección URL de la ubicación donde se movió el archivo o directorio.

Si este registro se obtuvo de un objeto Recordset, la nueva ubicación del archivo o directorio que se ha movido no se reflejará inmediatamente en el objeto Recordset. Actualice el objeto Recordset cerrando y abriéndolo de nuevo.

Nota

Las URL que usan el esquema http invocan automáticamente el Proveedor de Microsoft OLE DB para publicaciones en Internet. Para obtener más información, vea Direcciones URL absolutas y relativas.

Se aplica a

Objeto Record (ADO)

Consulte también

Move (método) (ADO)
Métodos MoveFirst, MoveLast, MoveNext y MovePrevious (ADO)
MoveFirst, MoveLast, MoveNext y MovePrevious métodos (RDS)