Método MoveRecord (ADO)
Se aplica a: Access 2013, Office 2013
Mueve a otra ubicación la entidad representada por un objeto Record.
Sintaxis
Graba. MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parámetros
| Parámetro | Descripción |
|---|---|
| Source | Es opcional. Valor de tipo String con una dirección URL que identifica el objeto Record que se va a mover. Si se omite Source o se especifica una cadena vacía, se mueve el objeto representado por este objeto Record. Por ejemplo, si el objeto Record representa un archivo, el contenido del archivo se mueve hacia la ubicación especificada por Destination. |
| Destino | Opcional. Valor de tipo String con la dirección URL que especifica la ubicación a la que se va a mover Source. |
| UserName | Opcional. Valor de tipo String con el identificador de usuario que, en caso de que sea necesario, autoriza el acceso a Destination. |
| Password | Opcional. Valor de tipo String con la contraseña que, en caso de que sea necesario, comprueba UserName. |
| Opciones | Es 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
Valor de tipo String. Normalmente se devuelve el valor de Destination. Sin embargo, el valor devuelto exacto depende del proveedor.
Comentarios
Los valores de Source y Destination no pueden ser idénticos; en caso contrario, se produce un error en tiempo de ejecución. Al menos los nombres de servidor, ruta de acceso o recurso deben ser diferentes.
En el caso de los archivos que se mueven mediante el proveedor de publicaciones en Internet, este método actualiza todos los vínculos de hipertexto en los archivos que se están moviendo, a menos que se especifique lo contrario en Options. Este método genera un error si Destination identifica un objeto existente (por ejemplo, un archivo o directorio), a menos que se especifique adMoveOverWrite.
Nota:
[!NOTA] Utilice la opción adMoveOverWrite con criterio. Por ejemplo, si especifica esta opción cuando mueve un archivo a un directorio, se eliminará el directorio y se reemplazará con el archivo.
Algunos atributos del objeto Record, como la propiedad ParentURL, no se actualizarán tras finalizar esta operación. Actualice las propiedades del objeto Record cerrando el objeto Record y abriéndolo de nuevo con la dirección URL de la ubicación a la que se ha movido el archivo o directorio.
Si este objeto Record se ha obtenido 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:
[!NOTA] Las direcciones URL que utilizan el esquema http llamarán automáticamente a Microsoft OLE DB Provider for Internet Publishing. Para obtener más información, consulte Direcciones URL absolutas y relativas.