CopyFile method (Método CopyFile)
Copia um ou mais arquivos de um local para outro.
Sintaxe
objeto. CopyFilesource, destination, [ overwrite ]
A sintaxe do método CopyFile tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. O objeto é sempre o nome de um FileSystemObject. |
| source | Obrigatório. Especificação do ficheiro de cadeia de carateres, que pode incluir carateres universais, para que um ou mais ficheiros sejam copiados. |
| destino | Obrigatório. Destino da cadeia de carateres onde o ficheiro ou ficheiros da origem devem ser copiados. Não são permitidos carateres universais. |
| substituir | Opcional. Valor booleano que indica se os ficheiros existentes devem ser substituídos. Se for Verdadeiro, os ficheiros são substituídos; se for Falso, não são. O padrão é True. Tenha em atenção que CopyFile falhará se o destino tiver o atributo só de leitura definido, independentemente do valor de substituição. |
Comentários
Os carateres universais só podem ser utilizados no último componente de caminho do argumento de origem . For example, you can use:
FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"
No entanto, não pode utilizar:
FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"
Se a origem contiver carateres universais ou o destino terminar com um separador de caminho (****), presume-se que o destino é uma pasta existente na qual copiar ficheiros correspondentes. Caso contrário, assume-se que o destino é o nome de um ficheiro a criar. Em ambos os casos, podem ocorrer três coisas quando um ficheiro individual é copiado:
Se o destino não existir, a origem é copiada. Este é o caso habitual.
Se o destino for um ficheiro existente, ocorrerá um erro se substituir for Falso. Caso contrário, é efetuada uma tentativa de copiar a origem através do ficheiro existente.
Se o destino for um diretório, ocorrerá um erro.
Também ocorrerá um erro se uma origem que utiliza carateres universais não corresponder a quaisquer ficheiros. O método CopyFile para no primeiro erro que encontrar. Não é efetuada nenhuma tentativa para reverter ou anular quaisquer alterações efetuadas antes de ocorrer um erro.
Os ficheiros copiados para um novo caminho de destino manterão o mesmo nome de ficheiro. Para mudar o nome do ficheiro copiado, inclua simplesmente o novo nome de ficheiro no caminho de destino. Por exemplo, isto irá copiar o ficheiro para uma nova localização e o ficheiro na nova localização 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.