Instrução Name
Muda o nome de um ficheiro de disco, diretório ou pasta.
Sintaxe
NomeoldpathnameComonewpathname
A sintaxe da instrução Nome tem as seguintes partes:
| Sair | Descrição |
|---|---|
| oldpathname | Obrigatório. Expressão de cadeia que especifica o nome e a localização do ficheiro existentes; pode incluir diretório ou pasta e unidade. |
| newpathname | Obrigatório. Expressão de cadeia que especifica o novo nome de ficheiro e localização; pode incluir diretório ou pasta e unidade. O nome de ficheiro especificado por newpathname ainda não pode existir. |
Comentários
A instrução Nome muda o nome de um ficheiro e move-o para um diretório ou pasta diferente, se necessário. O nome pode mover um ficheiro entre unidades, mas só pode mudar o nome de um diretório ou pasta existente quando o newpathname e o oldpathname estão localizados na mesma unidade. O nome não consegue criar um novo ficheiro, diretório ou pasta.
Utilizar o Nome num ficheiro aberto produz um erro. Tem de fechar um ficheiro aberto antes de mudar o nome do mesmo. Osargumentos de nome não podem incluir carateres universais de múltiplos carateres (*) e de caráter único (?).
Exemplo
Este exemplo utiliza a instrução Nome para mudar o nome de um ficheiro. Para efeitos deste exemplo, suponha que os diretórios ou pastas especificados já existem. No Macintosh, "HD:" é o nome da unidade predefinido e as 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.