Método MoveRecord (ADO)
Mueve la entidad representada por un record a otra ubicación.
Sintaxis
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parámetros
de origen de
Opcional. Valor de cadena que contiene una dirección URL que identifica el registro de que se va a mover. Si se omite source o especifica una cadena vacía, se mueve el objeto representado por este record. Por ejemplo, si el record de representa un archivo, el contenido del archivo se mueve a la ubicación especificada por Destination.
de destino de
Opcional. Valor cadena que contiene una dirección URL que especifica la ubicación donde se moverá origen.
UserName
Opcional. Valor string de 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 MoveRecordOptionsEnum cuyo valor predeterminado es adMoveUnspecified. Especifica el comportamiento de este método.
asincrónico
Opcional. Valor de booleano que, cuando True, especifica que esta operación debe ser asincrónica.
Valor devuelto
Valor de string de. Normalmente, se devuelve el valor de Destination. Sin embargo, el valor exacto devuelto depende del proveedor.
Observaciones
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 recursos 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 Opciones. 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, al especificar 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 de , como la propiedad ParentURL, no se actualizarán una vez completada esta operación. Actualice las propiedades de Record objeto cerrando el Recordy, a continuación, vuelva a abrirlo con la dirección URL de la ubicación donde se movió el archivo o directorio.
Si este record se obtuvo de un Recordset, la nueva ubicación del archivo o directorio movidos no se reflejará inmediatamente en el Recordset . Actualice el Recordset cerrando y abriéndolo de nuevo.
Nota
Las direcciones URL que usan el esquema http invocarán automáticamente el proveedor OLE DB de Microsoft para la publicación en Internet. Para obtener más información, vea direcciones URL absolutas y relativas.
Se aplica a
Consulte también
Move (método, ADO)
métodos MoveFirst, MoveLast, MoveNext y MovePrevious (ADO)
métodos MoveFirst, MoveLast, MoveNext y MovePrevious (RDS)