FileSystemProxy.RenameFile(String, String) Método

Definición

Cambia el nombre de un archivo.

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

Parámetros

file
String

Archivo cuyo nombre se va a cambiar.

newName
String

Nuevo nombre del 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 archivo no existe.

Hay un archivo o directorio existente 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 en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.

El usuario carece de permisos necesarios para ver la ruta de acceso.

El usuario no tiene 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 al que desea cambiar el nombre.

Comentarios

Este método no se puede usar para mover un archivo; use el MoveFile método 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
Cambiar el nombre de un archivo Cómo: Cambiar el nombre de un archivo

Se aplica a

Consulte también