FileSystemProxy.CopyDirectory Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Copia um diretório para outro diretório.
Sobrecargas
| Nome | Description |
|---|---|
| CopyDirectory(String, String) |
Copia um diretório para outro diretório. |
| CopyDirectory(String, String, UIOption) |
Copia um diretório para outro diretório. |
| CopyDirectory(String, String, Boolean) |
Copia um diretório para outro diretório. |
| CopyDirectory(String, String, UIOption, UICancelOption) |
Copia um diretório para outro diretório. |
CopyDirectory(String, String)
Copia um diretório para outro diretório.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName);member this.CopyDirectory : string * string -> unitPublic 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 diretório deve ser copiado.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\).
destinationDirectoryName ou sourceDirectoryName é ou uma Nothing cadeia de caracteres vazia.
O diretório de origem não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir o caminho.
Existe um arquivo de destino, mas não pode ser acessado.
Exemplos
O exemplo a seguir copia o diretório TestDirectory1 para TestDirectory2substituir arquivos existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 pelo caminho e o nome do diretório que você deseja copiar e o local para o qual deseja copiá-lo.
Comentários
Esse 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 houver 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 em que o caminho do arquivo ou 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.CopyDirectory método.
| Para | Veja |
|---|---|
| Copiar um diretório | Como copiar um diretório para outro diretório |
Confira também
- UICancelOption
- Objetos (Visual Basic)
- How to: Get the Collection of Files in a Directory in Visual Basic
- How to: Parse File Paths in Visual Basic
Aplica-se a
CopyDirectory(String, String, UIOption)
Copia um diretório para outro diretório.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic 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 diretório deve ser copiado.
- showUI
- UIOption
Se deseja acompanhar visualmente o progresso da operação. O padrão é UIOption.OnlyErrorDialogs.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\).
destinationDirectoryName ou sourceDirectoryName é ou uma Nothing cadeia de caracteres vazia.
O diretório de origem não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir o caminho.
Existe um arquivo de destino, mas não pode ser acessado.
ShowUI é definido UIOption.AllDialogs como e o usuário cancela a operação ou um ou mais arquivos no diretório não podem ser copiados.
Exemplos
O exemplo a seguir copia o diretório TestDirectory1 para TestDirectory2substituir arquivos existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 pelo caminho e o nome do diretório que você deseja copiar e o local para o qual deseja copiá-lo.
Comentários
Esse 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 houver 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 em que o caminho do arquivo ou 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.CopyDirectory método.
| Para | Veja |
|---|---|
| Copiar um diretório | Como copiar um diretório para outro diretório |
Confira também
- UICancelOption
- Objetos (Visual Basic)
- How to: Get the Collection of Files in a Directory in Visual Basic
- How to: Parse File Paths in Visual Basic
Aplica-se a
CopyDirectory(String, String, Boolean)
Copia um diretório para outro diretório.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, bool overwrite);member this.CopyDirectory : string * string * bool -> unitPublic 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 diretório deve ser copiado.
- overwrite
- Boolean
True para substituir arquivos existentes; caso contrário False. O padrão é False.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\).
destinationDirectoryName ou sourceDirectoryName é ou uma Nothing cadeia de caracteres vazia.
O diretório de origem não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir o caminho.
Existe um arquivo de destino, mas não pode ser acessado.
Exemplos
O exemplo a seguir copia o diretório TestDirectory1 para TestDirectory2substituir arquivos existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 pelo caminho e o nome do diretório que você deseja copiar e o local para o qual deseja copiá-lo.
Comentários
Esse 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 houver 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 que são causadas por um arquivo específico, como um arquivo existente durante uma mesclagem enquanto overwrite está definido como False. 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 em que o caminho do arquivo ou 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.CopyDirectory método.
| Para | Veja |
|---|---|
| Copiar um diretório | Como copiar um diretório para outro diretório |
Confira também
- UICancelOption
- Objetos (Visual Basic)
- How to: Get the Collection of Files in a Directory in Visual Basic
- How to: Parse File Paths in Visual Basic
Aplica-se a
CopyDirectory(String, String, UIOption, UICancelOption)
Copia um diretório para outro diretório.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic 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 diretório deve ser copiado.
- showUI
- UIOption
Se deseja acompanhar visualmente o progresso da operação. 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
O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho do dispositivo (começa com \\.\).
destinationDirectoryName ou sourceDirectoryName é ou uma Nothing cadeia de caracteres vazia.
O diretório de origem não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem permissões necessárias para exibir o caminho.
Existe um arquivo de destino, mas não pode ser acessado.
ShowUI é definido UIOption.AllDialogs como e o usuário cancela a operação ou um ou mais arquivos no diretório não podem ser copiados.
Exemplos
O exemplo a seguir copia o diretório TestDirectory1 para TestDirectory2substituir arquivos existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 pelo caminho e o nome do diretório que você deseja copiar e o local para o qual deseja copiá-lo.
Comentários
Esse 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 houver 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 em que o caminho do arquivo ou 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 exemplos de tarefas que envolvem o My.Computer.FileSystem.CopyDirectory método.
| Para | Veja |
|---|---|
| Copiar um diretório | Como copiar um diretório para outro diretório |
Confira também
- UICancelOption
- Objetos (Visual Basic)
- How to: Get the Collection of Files in a Directory in Visual Basic
- How to: Parse File Paths in Visual Basic