FileSystemProxy.RenameFile(String, String) Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.MyServices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

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 de archivo.

Excepciones

ArgumentException

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

ArgumentNullException

file es Nothing.

o bien

newName es Nothing o una cadena vacía.

FileNotFoundException

El archivo no existe.

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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 Procedimiento para cambiar el nombre de un archivo

Se aplica a

Consulte también