FileSystem.Rename(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 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 -> unitstatic member Rename : string * string -> unitPublic 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.
