Share via

Método MoveFile

  • Artigo

Move um ou mais arquivos de um local para outro.

Sintaxe

objeto. Origem moveFile,destino

A sintaxe do método MoveFile tem estas partes:

Sair Descrição
objeto Obrigatório. Sempre o nome de um FileSystemObject.
source Obrigatório. O caminho para o arquivo ou arquivos a serem movidos. A cadeia de caracteres de argumento de origem pode conter caracteres curinga somente no último componente de caminho.
Destino Obrigatório. O caminho para onde o arquivo ou os arquivos devem ser movidos. O argumento de destino não pode conter caracteres curinga.

Comentários

Se a origem contiver curingas ou destino terminar com um separador de caminho (****), presume-se que o destino especifica uma pasta existente na qual mover os arquivos correspondentes. Caso contrário, supõe-se que o destino seja o nome de um arquivo de destino a ser criado. Em ambos os casos, três coisas podem acontecer quando um arquivo individual é movido:

  • Se o destino não existir, o arquivo será movido. Este é o caso usual.

  • Se o destino for um arquivo existente, ocorrerá um erro.

  • Se o destino for um diretório, ocorrerá um erro.

Um erro também ocorrerá se um caractere curinga usado na origem não corresponder a nenhum arquivo. O método MoveFile para no primeiro erro encontrado. Nenhuma tentativa é feita para reverter as alterações feitas antes que o erro ocorra.

Importante

Esse método permite mover arquivos entre volumes somente se houver suporte do sistema operacional.

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.