FileSystem.Rename(String, String) Método

Referencia

Definición

Espacio de nombres:: Microsoft.VisualBasic

Ensamblado:: Microsoft.VisualBasic.Core.dll

Ensamblado:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

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 -> 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: SupportedOSPlatformAttribute

Excepciones

ArgumentException

La ruta de acceso no es válida.

FileNotFoundException

OldPath file does not exist.

IOException

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

Compartir vía