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

Artículo
08/23/2008

Actualización: noviembre 2007

Cambia el nombre de un archivo.

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

Parámetros

file
String. Archivo al que se va a cambiar el nombre. Obligatorio.
newName
String. Nuevo nombre del archivo. 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 o termina con una barra diagonal inversa (\) (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 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).

Comentarios

Este método no se puede utilizar para mover un archivo; utilice My.Computer.FileSystem.MoveFile (Método) para mover el archivo 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.RenameFile.

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

Ejemplo

En este ejemplo se cambia el nombre del archivo Test.txt por SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Cambie "C:\Test.txt" por la ruta de acceso y nombre de archivo del archivo al que desea cambiarle el nombre.

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
FileIOPermission	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

Referencia

My.Computer.FileSystem (Objeto)

FileSystem.RenameFile

Otros recursos

Crear, eliminar y mover archivos y directorios en Visual Basic

Share via