Método CopyFolder

  • Artigo

Copia recursivamente uma pasta de um local para outro.

Sintaxe

objeto. Origem, destino do CopyFolder, [ substituição ]

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 booliano que indica se as pastas existentes devem ser substituídas. Se True, os arquivos serão substituídos; se False, eles não são. O padrão é True.

Comentários

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 a origem contiver caracteres curinga ou o destino terminar com um separador de caminho (), presume-se que o destino seja uma pasta existente na qual copiar pastas e subpastas correspondentes. Caso contrário, supõe-se que o destino seja 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 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 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 nesse diretório e substituir for False.

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

O método CopyFolder é interrompido 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.