Método CopyFolder

Copia recursivamente uma pasta de um local para outro.

Sintaxe

objeto de teste. CopyFoldersource, destination, [ overwrite ]

A sintaxe do método CopyFolder tem estas partes:

Sair Descrição
objeto Obrigatório. Sempre o nome de um FileSystemObject.
source Obrigatório. Especificação da pasta de cadeia de caracteres, que pode incluir caracteres curinga, para que uma ou mais pastas sejam copiadas.
destino Obrigatório. Destino da cadeia de caracteres em que a pasta e as subpastas da origem devem ser copiadas. Caracteres curinga não são permitidos.
Substituir Opcional. Valor booleano que indica se as pastas existentes devem ser substituídas. Se for True, os arquivos serão substituídos; se for False, não serão. O padrão é True.

Comentários

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

FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"

Mas você não pode usar:

FileSystemObject.CopyFolder "c:\mydocuments\*\*", "c:\tempfolder\"

Se origem contiver caracteres curinga ou destino terminar com um separador de caminho (\), presume-se que destino seja uma pasta existente na qual copiar pastas e subpastas correspondentes. Caso contrário, destino será considerado o nome de uma pasta a ser criada. Em ambos os casos, quatro coisas podem acontecer quando uma pasta individual é copiada:

  • Se o destino não existir, a pasta de origem e todo o seu conteúdo serão copiados. Este é o caso usual.

  • Se o destino for um arquivo existente, ocorrerá um erro.

  • Se o destino for um diretório, será feita uma tentativa de copiar a pasta e todo o seu conteúdo. Se um arquivo contido na origem já existir no destino, ocorrerá um erro se a substituição for False. Caso contrário, ele tentará copiar o arquivo sobre o arquivo existente.

  • Se o destino for um diretório somente leitura, ocorrerá um erro se for feita uma tentativa de copiar um arquivo somente leitura existente para esse diretório e a substituição for falsa.

Um erro também ocorrerá se uma fonte que usa caracteres curinga não corresponder a nenhuma pasta.

O método CopyFolder para no primeiro erro encontrado. Nenhuma tentativa é feita para reverter as alterações feitas antes que ocorra 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.

  • Last updated on