Cómo: Mover un archivo en Visual Basic

Actualización: noviembre 2007

El método My.Computer.FileSystem.MoveFile se puede utilizar para mover un archivo a otra carpeta. Si la estructura de destino no existe, se creará.

Para mover un archivo

  • Utilice el método MoveFile para mover el archivo, especificando el nombre de archivo y la ubicación tanto del archivo de código fuente como del archivo de destino. En este ejemplo se mueve el archivo test.txt desde TestDir1 a TestDir2. Observe que se especifica el nombre del archivo de destino aunque sea igual que el nombre del archivo de código fuente.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", _
        "C:\TestDir2\test.txt")
    

Para mover un archivo y cambiarle el nombre

  • Utilice el método MoveFile para mover el archivo, especificando el nombre y la ubicación del archivo de código fuente, la ubicación de destino y el nuevo nombre en la ubicación de destino. Este ejemplo mueve el archivo llamado a test.txt desde TestDir1 a TestDir2 y le cambia el nombre por el de nexttest.txt.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", _
        "C:\TestDir2\nexttest.txt", _
        FileIO.UIOption.AllDialogs, _
        FileIO.UICancelOption.ThrowException)
    

Programación eficaz

Las condiciones siguientes pueden producir una excepción:

  • La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero, sólo contiene un espacio en blanco, contiene caracteres no válidos o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).

  • La ruta de acceso no es válida porque es Nothing (ArgumentNullException).

  • destinationFileName es Nothing o una cadena vacía (ArgumentNullException).

  • El archivo de código fuente no es válido o no existe (FileNotFoundException).

  • La ruta de acceso combinada apunta a un directorio existente, el archivo de destino existe y overwrite está establecido en False, está en uso un archivo del directorio que tiene el mismo nombre o el usuario no tiene permisos suficientes para tener acceso al archivo (IOException).

  • Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).

  • showUI está establecido en True, onUserCancel está establecido en ThrowException y el usuario ha cancelado la operación o se ha producido un error de E/S no especificado (OperationCanceledException).

  • La ruta supera la longitud máxima definida por el sistema (PathTooLongException).

  • El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

  • El usuario no tiene los permisos requeridos (UnauthorizedAccessException).

Vea también

Tareas

Cómo: Cambiar el nombre de un archivo en Visual Basic

Cómo: Mover una colección de archivos en Visual Basic

Cómo: Crear una copia de un archivo en un directorio diferente en Visual Basic

Cómo: Analizar rutas de acceso a archivos en Visual Basic

Cómo: Mover un directorio en Visual Basic

Referencia

My.Computer.FileSystem.MoveFile (Método)