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

Actualización: noviembre 2007

Cambia el nombre de un directorio.

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

Parámetros

• directory
  String. Ruta de acceso y nombre de directorio al que se va a cambiar el nombre. Obligatorio.

• newName
  String. Nuevo nombre para el directorio. Obligatorio.

Excepciones

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

• El parámetro newName contiene información de la ruta de acceso (ArgumentException).

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

• El parámetro 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 directorio con el nombre especificado en newName (IOException).

• El directorio es un directorio raíz (IOException).

• La ruta de acceso tiene más de 248 caracteres (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).

Comentarios

Este método no se puede utilizar para mover un directorio; utilice el método MoveDirectory para mover el directorio y cambiarle el nombre.

Tareas

En la tabla siguiente se incluye un ejemplo de una tarea en la que interviene el método My.Computer.FileSystem.RenameDirectory.

Ejemplo

Este ejemplo cambia el nombre del directorio Test a SecondTest.

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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

El permiso siguiente puede ser necesario:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

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

Referencia

My.Computer.FileSystem (Objeto)

RenameDirectory

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

Otros recursos

Crear, eliminar y mover archivos y directorios en Visual Basic