Partilhar via

Instrução Name

  • Artigo

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

Sintaxe

NomeoldpathnameComonewpathname

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 existentes; pode incluir diretório ou pasta e unidade.
newpathname Obrigatório. Expressão de cadeia de caracteres que especifica o novo nome e o local do 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. O nome pode mover um arquivo entre unidades, mas ele só pode renomear um diretório ou pasta existente quando newpathname e oldpathname estiverem localizados na mesma unidade. O nome não pode criar um novo arquivo, diretório ou pasta.

O uso de Nome em um arquivo aberto produz um erro. Você deve fechar um arquivo aberto antes de renomeá-lo. Osargumentos de nome não podem incluir curingas de caracteres múltiplos (*) e caractere único (?).

Exemplo

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

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.