Treinamento
Módulo
Trabalhar com arquivos e diretórios em um aplicativo do .NET - Training
Saiba como usar o .NET, o C# e o System.IO para trabalhar com diretórios, caminhos, arquivos e o sistema de arquivos.
Não há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
Copia um ou mais arquivos de um local para outro.
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. |
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"
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.
Treinamento
Módulo
Trabalhar com arquivos e diretórios em um aplicativo do .NET - Training
Saiba como usar o .NET, o C# e o System.IO para trabalhar com diretórios, caminhos, arquivos e o sistema de arquivos.
Documentação
Método CopyFolder (Visual Basic for Applications)
Tópico de referência do VBA do Office
Tópico de referência do VBA do Office
Método FileExists (Visual Basic for Applications)
Tópico de referência do VBA do Office