FileSystem.RenameFile(String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 del archivo.
Excepciones
newName contiene información de ruta de acceso o termina con una barra diagonal inversa (\).
El directorio 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 en Visual Basic |