FileSystemProxy.CopyDirectory Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Copia um diretório para outro diretório.
Sobrecargas
| Name | 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 onde o diretório deve ser copiado.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
destinationDirectoryName ou sourceDirectoryName é Nothing ou uma corda vazia.
O diretório fonte não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Existe um ficheiro de destino, mas não pode ser acedido.
Exemplos
O exemplo seguinte copia o diretório TestDirectory1 para TestDirectory2, sobrescrevendo ficheiros existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 com o caminho e o nome do diretório que pretende copiar e o local para onde pretende copiar.
Observações
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, é criado. Se existir um diretório com o mesmo nome na localização de destino, o conteúdo dos dois diretórios é fundido. Pode especificar um novo nome para o diretório durante a operação.
Ao copiar ficheiros dentro de um diretório, podem ser lançadas exceções causadas por um ficheiro específico. Quando tais exceções são lançadas, são consolidadas numa única exceção cuja Data propriedade contém entradas sob a forma de um IDictionary em que o caminho do ficheiro ou diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar as entradas.
A tabela seguinte 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 |
Ver também
- UICancelOption
- Objects (Visual Basic)
- Como: Obter a coleção de ficheiros num diretório em Visual Basic
- Como: Analisar caminhos de ficheiros em 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 onde o diretório deve ser copiado.
- showUI
- UIOption
Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
destinationDirectoryName ou sourceDirectoryName é Nothing ou uma corda vazia.
O diretório fonte não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Existe um ficheiro de destino, mas não pode ser acedido.
ShowUI é definido para UIOption.AllDialogs e o utilizador cancela a operação, ou um ou mais ficheiros no diretório não podem ser copiados.
Exemplos
O exemplo seguinte copia o diretório TestDirectory1 para TestDirectory2, sobrescrevendo ficheiros existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 com o caminho e o nome do diretório que pretende copiar e o local para onde pretende copiar.
Observações
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, é criado. Se existir um diretório com o mesmo nome na localização de destino, o conteúdo dos dois diretórios é fundido. Pode especificar um novo nome para o diretório durante a operação.
Ao copiar ficheiros dentro de um diretório, podem ser lançadas exceções causadas por um ficheiro específico. Quando tais exceções são lançadas, são consolidadas numa única exceção cuja Data propriedade contém entradas sob a forma de um IDictionary em que o caminho do ficheiro ou diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar as entradas.
A tabela seguinte 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 |
Ver também
- UICancelOption
- Objects (Visual Basic)
- Como: Obter a coleção de ficheiros num diretório em Visual Basic
- Como: Analisar caminhos de ficheiros em 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 onde o diretório deve ser copiado.
- overwrite
- Boolean
True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
destinationDirectoryName ou sourceDirectoryName é Nothing ou uma corda vazia.
O diretório fonte não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Existe um ficheiro de destino, mas não pode ser acedido.
Exemplos
O exemplo seguinte copia o diretório TestDirectory1 para TestDirectory2, sobrescrevendo ficheiros existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 com o caminho e o nome do diretório que pretende copiar e o local para onde pretende copiar.
Observações
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, é criado. Se existir um diretório com o mesmo nome na localização de destino, o conteúdo dos dois diretórios é fundido. Pode especificar um novo nome para o diretório durante a operação.
Ao copiar ficheiros dentro de um diretório, podem ser lançadas exceções causadas por um ficheiro específico, como um ficheiro existente durante uma fusão enquanto overwrite está definido para False. Quando tais exceções são lançadas, são consolidadas numa única exceção cuja Data propriedade contém entradas sob a forma de um IDictionary em que o caminho do ficheiro ou diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar as entradas.
A tabela seguinte 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 |
Ver também
- UICancelOption
- Objects (Visual Basic)
- Como: Obter a coleção de ficheiros num diretório em Visual Basic
- Como: Analisar caminhos de ficheiros em 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 onde o diretório deve ser copiado.
- showUI
- UIOption
Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Especifica o que deve ser feito se o utilizador clicar em Cancelar durante a operação. A predefinição é ThrowException.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
destinationDirectoryName ou sourceDirectoryName é Nothing ou uma corda vazia.
O diretório fonte não existe.
O caminho de origem e o caminho de destino são os mesmos.
A operação é cíclica.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de pasta no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
Existe um ficheiro de destino, mas não pode ser acedido.
ShowUI é definido para UIOption.AllDialogs e o utilizador cancela a operação, ou um ou mais ficheiros no diretório não podem ser copiados.
Exemplos
O exemplo seguinte copia o diretório TestDirectory1 para TestDirectory2, sobrescrevendo ficheiros existentes.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Substitua C:\TestDirectory1 e C:\TestDirectory2 com o caminho e o nome do diretório que pretende copiar e o local para onde pretende copiar.
Observações
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, é criado. Se existir um diretório com o mesmo nome na localização de destino, o conteúdo dos dois diretórios é fundido. Pode especificar um novo nome para o diretório durante a operação.
Ao copiar ficheiros dentro de um diretório, podem ser lançadas exceções causadas por um ficheiro específico. Quando tais exceções são lançadas, são consolidadas numa única exceção cuja Data propriedade contém entradas sob a forma de um IDictionary em que o caminho do ficheiro ou diretório é a chave e a mensagem de exceção específica está contida no valor correspondente. Use For…Each para enumerar as entradas.
A tabela seguinte 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 |
Ver também
- UICancelOption
- Objects (Visual Basic)
- Como: Obter a coleção de ficheiros num diretório em Visual Basic
- Como: Analisar caminhos de ficheiros em Visual Basic