Compartir a través de

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

  • Artículo

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