FileSystem.CopyDirectory Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Copia o conteúdo de um diretório para outro diretório.

Sobrecargas

CopyDirectory(String, String)	Copia o conteúdo de um diretório para outro diretório.
CopyDirectory(String, String, UIOption)	Copia o conteúdo de um diretório para outro diretório.
CopyDirectory(String, String, Boolean)	Copia o conteúdo de um diretório para outro diretório.
CopyDirectory(String, String, UIOption, UICancelOption)	Copia o conteúdo de um diretório para outro diretório.

CopyDirectory(String, String)

Origem:

FileSystem.vb

Copia o conteúdo de um diretório para outro diretório.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);

static member CopyDirectory : string * string -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

Parâmetros

sourceDirectoryName

String

O diretório a ser copiado.

destinationDirectoryName

String

O local para o qual o conteúdo do diretório deve ser copiado.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

destinationDirectoryName ou sourceDirectoryName é Nothing ou uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório de origem não existe.

IOException

O caminho de origem e o caminho de destino são os mesmos.

InvalidOperationException

A operação é cíclica.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de pasta no caminho contém dois pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

Um arquivo de destino existe, mas não pode ser acessado.

Exemplos

O exemplo a seguir copia o conteúdo do diretório TestDirectory1 para TestDirectory2.

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

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

Comentários

Esse método copia o conteúdo do diretório de origem para o diretório de destino. Se o diretório de destino não existir, ele será criado. Se existir um diretório com o mesmo nome no local de destino, o conteúdo dos 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, podem ser geradas exceções causadas por um arquivo específico. Quando essas exceções são geradas, elas são consolidadas em uma única exceção cuja Data propriedade contém entradas na forma de um IDictionary no qual o arquivo ou caminho do diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar por meio das entradas.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.CopyDirectory método .

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

Confira também

• UICancelOption

CopyDirectory(String, String, UIOption)

Origem:

FileSystem.vb

Copia o conteúdo de um diretório para outro diretório.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

Parâmetros

sourceDirectoryName

String

O diretório a ser copiado.

destinationDirectoryName

String

O local para o qual o conteúdo do diretório deve ser copiado.

showUI

UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

destinationDirectoryName ou sourceDirectoryName é Nothing ou uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório de origem não existe.

IOException

O caminho de origem e o caminho de destino são os mesmos.

InvalidOperationException

A operação é cíclica.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de pasta no caminho contém dois pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

Um arquivo de destino existe, mas não pode ser acessado.

OperationCanceledException

ShowUI está definido como UIOption.AllDialogs e o usuário cancelou a operação ou um ou mais arquivos no diretório não podem ser copiados.

Exemplos

O exemplo a seguir copia o conteúdo do diretório TestDirectory1 para TestDirectory2, mostrando a caixa de diálogo de progresso e qualquer caixa de diálogo de erro.

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

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

Comentários

Esse método copia o conteúdo do diretório de origem para o diretório de destino. Se o diretório de destino não existir, ele será criado. Se existir um diretório com o mesmo nome no local de destino, o conteúdo dos 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, podem ser geradas exceções causadas por um arquivo específico. Quando essas exceções são geradas, elas são consolidadas em uma única exceção cuja Data propriedade contém entradas na forma de um IDictionary no qual o arquivo ou caminho do diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar por meio das entradas.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.CopyDirectory método .

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

Confira também

• UICancelOption

CopyDirectory(String, String, Boolean)

Origem:

FileSystem.vb

Copia o conteúdo de um diretório para outro diretório.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);

static member CopyDirectory : string * string * bool -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

Parâmetros

sourceDirectoryName

String

O diretório a ser copiado.

destinationDirectoryName

String

O local para o qual o conteúdo do diretório deve ser copiado.

overwrite

Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

destinationDirectoryName ou sourceDirectoryName é Nothing ou uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório de origem não existe.

IOException

O caminho de origem e o caminho de destino são os mesmos.

InvalidOperationException

A operação é cíclica.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de pasta no caminho contém dois pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

Um arquivo de destino existe, mas não pode ser acessado.

Exemplos

O exemplo a seguir copia o conteúdo do diretório TestDirectory1 em TestDirectory2, substituindo arquivos existentes.

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

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

Comentários

Esse método copia o conteúdo do diretório de origem para o diretório de destino. Se o diretório de destino não existir, ele será criado. Se existir um diretório com o mesmo nome no local de destino, o conteúdo dos 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 geradas causadas por um arquivo específico, como um arquivo existente durante uma mesclagem enquanto overwrite é definido Falsecomo . Quando essas exceções são geradas, elas são consolidadas em uma única exceção cuja Data propriedade contém entradas na forma de um IDictionary no qual o arquivo ou caminho do diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar por meio das entradas.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.CopyDirectory método .

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

Confira também

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

Origem:

FileSystem.vb

Copia o conteúdo de um diretório para outro diretório.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parâmetros

sourceDirectoryName

String

O diretório a ser copiado.

destinationDirectoryName

String

O local para o qual o conteúdo do diretório deve ser copiado.

showUI

UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Especifica o que deve ser feito se o usuário clicar em Cancelar durante a operação. O padrão é ThrowException.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

destinationDirectoryName ou sourceDirectoryName é Nothing ou uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório de origem não existe.

IOException

O caminho de origem e o caminho de destino são os mesmos.

InvalidOperationException

A operação é cíclica.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de pasta no caminho contém dois pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

Um arquivo de destino existe, mas não pode ser acessado.

OperationCanceledException

ShowUI está definido como UIOption.AllDialogs e o usuário cancelou a operação ou um ou mais arquivos no diretório não podem ser copiados.

Exemplos

O exemplo a seguir copia o conteúdo do diretório TestDirectory1 para TestDirectory2, mostrando a caixa de diálogo de progresso e qualquer caixa de diálogo de erro e não faz nada se o usuário clica em Cancelar durante a operação.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

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

Comentários

Esse método copia o conteúdo do diretório de origem para o diretório de destino. Se o diretório de destino não existir, ele será criado. Se existir um diretório com o mesmo nome no local de destino, o conteúdo dos 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, podem ser geradas exceções causadas por um arquivo específico. Quando essas exceções são geradas, elas são consolidadas em uma única exceção cuja Data propriedade contém entradas na forma de um IDictionary no qual o arquivo ou caminho do diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar por meio das entradas.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.CopyDirectory método .

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

Confira também

• UICancelOption