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 de disco. La My característica proporciona una mayor productividad y rendimiento en las operaciones de E/S de archivos que Rename. Para obtener más información, consulte FileSystem.
public:
static void Rename(System::String ^ OldPath, System::String ^ NewPath);public static void Rename(string OldPath, string NewPath);static member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parámetros
- OldPath
- String
Required. Expresión de cadena que especifica el nombre de archivo y la ubicación existentes.
OldPath puede incluir el directorio y la unidad del archivo.
- NewPath
- String
Required. Expresión de cadena que especifica el nuevo nombre de archivo y la ubicación.
NewPath puede incluir el directorio y la unidad de la ubicación de destino. El nombre de archivo especificado por NewPath no puede existir.
Excepciones
La ruta de acceso no es válida.
OldPath el archivo no existe.
No se puede cambiar el nombre a otro dispositivo.
Ejemplos
En este ejemplo se usa la función para cambiar el Rename nombre de un archivo. Para los fines de 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 ambos NewPath y OldPath 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 cambiar su 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 desprotegida a una ubicación protegida, el archivo conserva los derechos menos restringidos. Compruebe que no está introduciendo un riesgo de seguridad posible.