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

Actualización: noviembre 2007

El método RenameDirectory del objeto My.Computer.FileSystem se puede utilizar para cambiar el nombre de un directorio proporcionando la ubicación y el nombre actuales del directorio junto con el nuevo nombre el mismo. Este método no se puede utilizar para mover un directorio; utilice el método MoveDirectory para mover el directorio y cambiarle el nombre.

Para cambiar el nombre de un directorio

  • Utilice el método My.Computer.FileSystem.RenameDirectory para cambiar el nombre de un directorio. El código siguiente cambia el nombre del directorio Test a SecondTest.

    My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", _
    "SecondTest")
    

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 ejemplo 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 circunstancias 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, 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 directorio de origen no es válido o no existe (DirectoryNotFoundException).

  • Ya hay un archivo o carpeta con el nombre especificado en newName (IOException).

  • La carpeta es una carpeta raíz (IOException).

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

  • Un nombre de archivo o de carpeta en la ruta de acceso contiene dos puntos (:) o está en 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: Copiar un directorio en otro directorio en Visual Basic

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

Cómo: Mover un directorio en Visual Basic

Cómo: Mover el contenido de un directorio en Visual Basic

Referencia

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