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

  • Artículo

Actualización: noviembre 2007

Utilice 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 nuevo nombre de archivo. Este método no se puede utilizar para mover archivos; utilice MoveFile para mover un archivo y cambiarle el nombre.

Para cambiar el nombre de un archivo

  • Utilice 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 - Procesando unidades, carpetas y archivos. Para obtener más información, vea Cómo: Insertar fragmentos de código en el código (Visual Basic).

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

  • newName contiene información de la 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 código fuente no es válido o no existe (FileNotFoundException).

  • Ya 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 los permisos requeridos (UnauthorizedAccessException).

Vea también

Tareas

Cómo: Mover 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 el mismo directorio en Visual Basic

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

Referencia

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

Otros recursos

Crear, eliminar y mover archivos y directorios en Visual Basic