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

Use el método RenameFile del objeto My.Computer.FileSystem para cambiar el nombre de un archivo proporcionando la ubicación actual, el nombre de archivo y el nombre de archivo nuevo. No se puede usar este método para mover un archivo. Use el método MoveFile para mover y cambiar el nombre del archivo.

Para cambiar el nombre de un archivo

  • Use el método My.Computer.FileSystem.RenameFile para cambiar el nombre de un archivo. En este ejemplo se cambia el nombre del archivo Test.txt por SecondTest.txt.

    ' Change "c:\test.txt" to the path and filename for the file that
    ' you want to rename.
    My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
    

Este ejemplo de código también está disponible como fragmento de código de IntelliSense. En el selector de fragmentos de código, el fragmento de código se encuentra en Sistema de archivos - procesamiento de unidades, carpetas y archivos. Para obtener más información, vea Fragmentos de código.

Programación sólida

Las condiciones siguientes pueden provocar una excepción:

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

  • newName contiene información de ruta de acceso (ArgumentException).

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

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

  • El archivo de origen no es válido o no existe (FileNotFoundException).

  • Hay un archivo o directorio con el nombre especificado en newName (IOException).

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

  • 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).

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

  • El usuario no tiene el permiso necesario (UnauthorizedAccessException).

Vea también