Compartir a través de


FileSystem.Rename(String, String) Método

Definición

Cambia el nombre de un archivo o directorio ubicado en el disco. La característica My proporciona una mayor productividad y rendimiento en las operaciones de E/S de archivo que Rename. Para obtener más información, vea FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

Parámetros

OldPath
String

Obligatorio. Expresión de cadena que especifica el nombre y la ubicación de archivo existentes. OldPath puede incluir el directorio y la unidad del archivo.

NewPath
String

Obligatorio. Expresión de cadena que especifica el nombre y la ubicación de archivo nuevos. NewPath puede incluir el directorio y la unidad de la ubicación de destino. El nombre de archivo especificado por NewPath no puede existir.

Atributos

Excepciones

La ruta de acceso no es válida.

OldPath file does not exist.

No se puede cambiar el nombre en un dispositivo diferente.

Ejemplos

En este ejemplo se usa la función para cambiar el Rename nombre de un archivo. Para este ejemplo, supongamos que los directorios especificados ya existen.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

Comentarios

LaRename función cambia el nombre de un archivo y la mueve a un directorio diferente, si es necesario. La Rename función puede mover un archivo entre unidades, pero solo puede cambiar el nombre de un directorio existente cuando y NewPathOldPath se encuentran en la misma unidad. Rename no puede crear un nuevo archivo o directorio.

El uso de la Rename función en un archivo abierto genera un error. Debe cerrar un archivo abierto antes de cambiarle el nombre. Rename los argumentos no pueden incluir caracteres comodín de varios caracteres (*) y de un solo carácter (?).

Importante

Cuando se usa Rename para copiar un archivo desde una ubicación no protegida a una ubicación protegida, el archivo conserva los derechos menos restringidos. Asegúrese de que no está introduciendo un riesgo de seguridad posible.

Se aplica a

Consulte también