Rename (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Cambia el nombre de un archivo de disco o directorio.

La característica My proporciona mayor productividad y rendimiento en las operaciones de E/S de archivo que si se utiliza Rename. Para obtener más información, vea My.Computer.FileSystem (Objeto).

Public Sub Rename( _
   ByVal OldPath As String, _
   ByVal NewPath As String _
)

Parámetros

OldPath
Obligatorio. Expresión String que especifica el nombre del archivo existente y su ubicación. OldPath puede incluir el directorio y la unidad del archivo.
NewPath
Obligatorio. Expresión String que especifica el nuevo nombre del archivo y su 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

Tipo de excepción	Número de error	Condición
ArgumentException	5	La ruta de acceso no es válida.
FileNotFoundException	53	El archivo OldPath no existe.
IOException	58	El archivo NewPathya existe.
IOException	75	El acceso no es válido.
IOException	74	No se puede cambiar el nombre en un dispositivo diferente.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

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

Si se utiliza la función Rename en un archivo abierto, se genera un error. Debe cerrar un archivo abierto antes de cambiarle el nombre. Los argumentos Rename no pueden incluir comodines de varios caracteres (*) y de un único carácter (?).

Nota de seguridad:
Al utilizar Rename para copiar un archivo desde una ubicación no protegida a una ubicación protegida, el archivo conserva los derechos menos restrictivos. Compruebe que no está provocando un riesgo para la seguridad.

Ejemplo

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

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)