Instrução Name

Renomeia um arquivo, diretório ou pasta de disco.

Sintaxe

Name: oldpathnameAsnewpathname

A sintaxe da instrução Name tem estas partes:

Sair Descrição
OldPathName Obrigatório. Expressão de cadeia de caracteres que especifica o nome e o local do arquivo existente; Pode incluir diretório ou pasta e unidade.
novonome do caminho Obrigatório. Expressão de cadeia de caracteres que especifica o nome e o local do novo arquivo; Pode incluir diretório ou pasta e unidade. O nome do arquivo especificado por newpathname ainda não pode existir.

Comentários

A instrução Name renomeia um arquivo e o move para um diretório ou pasta diferente, se necessário. Name pode mover um arquivo entre unidades, mas só pode renomear um diretório ou pasta existente quando newpathname e oldpathname estão localizados na mesma unidade. O nome não pode criar um novo arquivo, diretório ou pasta.

Usar o Nome em um arquivo aberto produz um erro. É necessário fechar um arquivo aberto antes de renomeá-lo. Osargumentos de nome não podem incluir caracteres curinga de vários caracteres (*) e de um único caractere (?).

Exemplo

Este exemplo usa a instrução Name para renomear um arquivo. Para os fins deste exemplo, suponha que os diretórios ou pastas especificados já existam. No Macintosh, "HD:" é o nome da unidade padrão e partes do nome do caminho são separadas por dois-pontos em vez de barras invertidas.

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. 

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.