Share via

Método CopyFile

  • Artigo

Copia um ou mais arquivos de um local para outro.

Sintaxe

objeto. CopyFilesource, destination, [ overwrite ]

A sintaxe do método CopyFile tem estas partes:

Sair Descrição
objeto Obrigatório. O objeto é sempre o nome de um FileSystemObject.
source Obrigatório. Especificação do arquivo de cadeia de caracteres, que pode incluir caracteres curinga, para que um ou mais arquivos sejam copiados.
Destino Obrigatório. Destino da cadeia de caracteres em que o arquivo ou os arquivos da origem devem ser copiados. Caracteres curinga não são permitidos.
Substituir Opcional. Valor booliano que indica se os arquivos existentes devem ser substituídos. Se True, os arquivos serão substituídos; se False, eles não são. O padrão é True. Observe que CopyFile falhará se o destino tiver o conjunto de atributos somente leitura, independentemente do valor da substituição.

Comentários

Caracteres curinga só podem ser usados no último componente de caminho do argumento de origem . For example, you can use:

FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"

Mas você não pode usar:

FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"

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

  • Se o destino não existir, a origem será copiada. Este é o caso usual.

  • Se o destino for um arquivo existente, ocorrerá um erro se a substituição for False. Caso contrário, é feita uma tentativa de copiar a origem sobre o arquivo existente.

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

Um erro também ocorrerá se uma origem usando caracteres curinga não corresponder a nenhum arquivo. O método CopyFile é interrompido no primeiro erro encontrado. Nenhuma tentativa é feita para reverter ou desfazer quaisquer alterações feitas antes que ocorra um erro.

Os arquivos copiados para um novo caminho de destino manterão o mesmo nome de arquivo. Para renomear o arquivo copiado, basta incluir o novo nome do arquivo no caminho de destino. Por exemplo, isso copiará o arquivo para um novo local e o arquivo no novo local terá um nome diferente:

FileSystemObject.CopyFile "c:\mydocuments\letters\sample.doc", "c:\tempfolder\sample_new.doc"

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.