Compartir a través de


FileSystem.RenameFile(String, String) Método

Definición

Cambia el nombre de un archivo.

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);
public static void RenameFile (string file, string newName);
static member RenameFile : string * string -> unit
Public Shared Sub RenameFile (file As String, newName As String)

Parámetros

file
String

Archivo cuyo nombre se va a cambiar.

newName
String

Nuevo nombre de archivo.

Excepciones

newName contiene información de ruta de acceso o termina con una barra diagonal inversa (\).

file es Nothing.

o bien

newName es Nothing o una cadena vacía.

El directorio no existe.

Ya hay un archivo o directorio con el nombre especificado en newName.

La ruta de acceso supera la longitud máxima definida por el sistema.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

El usuario no tiene el permiso necesario.

Ejemplos

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

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

Cambie "C:\Test.txt" a la ruta de acceso y el nombre de archivo del archivo cuyo nombre desea cambiar.

Comentarios

No se puede usar este método para mover un archivo. Use el método MoveFile para mover y cambiar el nombre del archivo.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.FileSystem.RenameFile método .

En Vea
Cambio del nombre de un archivo Cómo: Cambiar el nombre de un archivo en Visual Basic

Se aplica a