CopyFolder method (Método CopyFolder)
Copia recursivamente uma pasta de uma localização para outra.
Sintaxe
objeto. CopyFoldersource, destination, [ overwrite ]
A sintaxe do método CopyFolder tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Sempre o nome de um FileSystemObject. |
| source | Obrigatório. Especificação da pasta de cadeia de carateres, que pode incluir carateres universais, para que uma ou mais pastas sejam copiadas. |
| destino | Obrigatório. Destino da cadeia de carateres onde a pasta e as subpastas da origem devem ser copiadas. Não são permitidos carateres universais. |
| substituir | Opcional. Valor booleano que indica se as pastas existentes devem ser substituídas. Se for Verdadeiro, os ficheiros são substituídos; se for Falso, não são. O padrão é True. |
Comentários
Os carateres universais só podem ser utilizados no último componente de caminho do argumento de origem . For example, you can use:
FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"
No entanto, não pode utilizar:
FileSystemObject.CopyFolder "c:\mydocuments\*\*", "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 para copiar pastas e subpastas correspondentes. Caso contrário, assume-se que o destino é o nome de uma pasta a criar. Em ambos os casos, podem ocorrer quatro coisas quando uma pasta individual é copiada:
Se o destino não existir, a pasta de origem e todos os respetivos conteúdos serão copiados. Este é o caso habitual.
Se o destino for um ficheiro existente, ocorrerá um erro.
Se o destino for um diretório, é efetuada uma tentativa de copiar a pasta e todo o respetivo conteúdo. Se um ficheiro contido na origem já existir no destino, ocorrerá um erro se substituir for Falso. Caso contrário, tentará copiar o ficheiro através do ficheiro existente.
Se o destino for um diretório só de leitura, ocorrerá um erro se for efetuada uma tentativa de copiar um ficheiro só de leitura existente para esse diretório e substituir for Falso.
Também ocorrerá um erro se uma origem que utiliza carateres universais não corresponder a nenhuma pasta.
O método CopyFolder para no primeiro erro que encontrar. Não é efetuada qualquer tentativa para reverter quaisquer alterações efetuadas antes de ocorrer um erro.
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.