Método My.Computer.FileSystem.CopyDirectory

Artigo
08/25/2010

Copia um diretório para outro diretório.

' Usage
My.Computer.FileSystem.CopyDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.CopyDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.CopyDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.CopyDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)
' Declaration
Public Sub CopyDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub CopyDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub CopyDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub CopyDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

sourceDirectoryName
String.O diretório a ser copiado.Obrigatório.
destinationDirectoryName
String.O local ao qual o diretório deve ser copiado.Obrigatório.
overwrite
Boolean.Ou não os arquivos existentes devem ser substituídos.O padrão é False.Obrigatório.
showUI
UIOption.Se rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
onUserCancel
UICancelOption.Especifica o que deve ser concluído se o usuário clica em Cancelar durante a operação.O padrão é ThrowException.Obrigatório.

Exceções

As seguintes condições podem causar uma exceção:

O novo nome especificado para o diretório contém dois-pontos (:) ou de barra (\ ou /) (ArgumentException).
O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
destinationDirectoryName é Nothing ou uma sequência de caracteres vazia (ArgumentNullException).
O diretório de origem não existe (DirectoryNotFoundException).
A diretório de origem é um diretório raiz (IOException).
O caminho combinado aponta para uma arquivo existente (IOException).
O caminho de origem e o caminho de destino são o mesmo (IOException).
ShowUI é definida como UIOption.AllDialogs e o usuário cancela a operação, ou um ou mais arquivos no diretório não podem ser copiados (OperationCanceledException).
A operação é cíclica (InvalidOperationException).
O caminho contém dois-pontos (:) (NotSupportedException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um arquivo ou nome da pasta no caminho contém dois-pontos (:) ou está em formato inválido (NotSupportedException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
Um arquivo de destino existe mas não pode ser acessado (UnauthorizedAccessException).

Comentários

Este método copia o conteúdo do diretório, bem como o próprio diretório.Se o diretório de destino não existir, ele será criado.Se existe um diretório com o mesmo nome no local de destino, o Sumário de dois diretórios será mesclado.Você pode especificar um novo nome para o diretório durante a operação.

Ao copiar arquivos em um diretório, exceções podem ser lançadas causados por um arquivo específico, tal sistema autônomo um arquivo existente durante uma mesclagem enquanto overwrite é definido sistema autônomo False. Quando essas exceções são lançadas, eles são consolidados em uma única exceção cujo Data propriedade mantém as entradas na forma de um IDictionary em que o arquivo ou caminho do diretório é a chave e a mensagem de exceção específico está contida em valor correspondente. Use For…Each para enumerar as entradas.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.CopyDirectory.

Para	Consulte
Copiar um diretório	Como: Copiar um diretório para outro diretório no Visual Basic

Exemplo

O exemplo a seguir copia o diretório TestDirectory1 em TestDirectory2, sobrescrevendo arquivos existentes.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

Substituir C:\TestDirectory1 e C:\TestDirectory2 com o caminho e nome do diretório que você deseja copiar e o local para a qual você deseja copiá-lo.

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: SafeSubWindows.