Instrucción Name Name statement

Cambia el nombre de un archivo de disco, un directorio o una carpeta.Renames a disk file, directory, or folder.

SintaxisSyntax

Name oldpathname As newpathnameName oldpathname As newpathname


La sintaxis de la instrucción Name contiene los elementos siguientes:The Name statement syntax has these parts:

PartPart DescripciónDescription
oldpathnameoldpathname Necesario.Required. Expresión de cadena que especifica el nombre y la ubicación del archivo existente; puede incluir el directorio o la carpeta, y la unidad.String expression that specifies the existing file name and location; may include directory or folder, and drive.
newpathnamenewpathname Necesario.Required. Expresión de cadena que especifica el nuevo nombre de archivo y la ubicación; puede incluir el directorio o la carpeta, y la unidad.String expression that specifies the new file name and location; may include directory or folder, and drive. newpathname no puede especificar un nombre existente.The file name specified by newpathname can't already exist.

ObservacionesRemarks

La instrucción Name cambia el nombre de un archivo y lo mueve a un directorio o carpeta diferente, si es necesario.The Name statement renames a file and moves it to a different directory or folder, if necessary. Name puede mover un archivo entre unidades, pero solo puede cambiar el nombre de una carpeta o directorio existente cuando tanto newpathname como oldpathname se encuentran en la misma unidad.Name can move a file across drives, but it can only rename an existing directory or folder when both newpathname and oldpathname are located on the same drive. Name no puede crear un nuevo archivo, directorio o carpeta.Name cannot create a new file, directory, or folder.

Using Name on an open file produces an error.Using Name on an open file produces an error. You must close an open file before renaming it.You must close an open file before renaming it. Nombre de los argumentos no pueden incluir caracteres comodín***** de carácter múltiple () y de carácter único (?).Name arguments cannot include multiple-character (*) and single-character (?) wildcards.

EjemploExample

Este ejemplo usa la instrucción Name para cambiar el nombre de un archivo.This example uses the Name statement to rename a file. Para este ejemplo, suponga que los directorios o las carpetas que se especifican son elementos existentes.For purposes of this example, assume that the directories or folders that are specified already exist. En Macintosh, "HD:" es el nombre de unidad predeterminado y las partes de la ruta de ruta están separadas por dos puntos en lugar de barras diagonales inversas.On the Macintosh, "HD:" is the default drive name, and portions of the pathname are separated by colons instead of backslashes.

Dim OldName, NewName 
OldName = "OLDFILE": NewName = "NEWFILE" ' Define file names. 
Name OldName As NewName ' Rename file. 
 
OldName = "C:\MYDIR\OLDFILE": NewName = "C:\YOURDIR\NEWFILE" 
Name OldName As NewName ' Move and rename file. 

Vea tambiénSee also

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.