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 de archivo.
Excepciones
newName
contiene información de ruta de acceso o termina con una barra diagonal inversa (\).
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 |