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.
Para |
Vea |
---|---|
Cambiar el nombre de un directorio |
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
Tipo de proyecto |
Disponible |
---|---|
Aplicación para Windows |
Sí |
Biblioteca de clases |
Sí |
Aplicación de consola |
Sí |
Biblioteca de controles de Windows |
Sí |
Biblioteca de controles Web |
Sí |
Servicio de Windows |
Sí |
Sitio Web |
Sí |
Permisos
El permiso siguiente puede ser necesario:
Permiso |
Descripción |
---|---|
Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted. |
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)
My.Computer.FileSystem.MoveDirectory (Método)
Otros recursos
Crear, eliminar y mover archivos y directorios en Visual Basic