Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Copia um ou mais arquivos de um local para outro.
Sintaxe
objeto de teste. 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 de 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 onde o arquivo ou arquivos da origem devem ser copiados. Caracteres curinga não são permitidos. |
| Substituir | Opcional. Valor booleano que indica se os arquivos existentes devem ser substituídos. Se for True, os arquivos serão substituídos; se for False, não serão. O padrão é True. Observe que CopyFile falhará se o destino tiver o atributo somente leitura definido, independentemente do valor de substituição. |
Comentários
Os 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 origem contiver caracteres curinga ou destino terminar com um separador de caminho (****), presume-se que destino é uma pasta existente na qual copiar arquivos correspondentes. Caso contrário, destino será considerado 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, será feita uma tentativa de copiar o código-fonte 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 para no primeiro erro encontrado. Nenhuma tentativa é feita para reverter ou desfazer as alterações feitas antes que ocorra um erro.
Files 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.