Método My.Computer.FileSystem.MoveDirectory

Artigo
08/25/2010

Move um diretório de um local para outro.

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

sourceDirectoryName
String.Caminho do diretório a ser movido.Obrigatório.
destinationDirectoryName
String.Caminho de diretório ao qual o diretório de fonte está sendo movido.Obrigatório.
overwrite
Boolean.Especifica se os diretórios existentes devem ser substituídos.O padrão é False.Obrigatório.
showUI
UIOption.Especifica se deve ser rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
onUserCancel
Enumeração UICancelOption.Especifica se uma exceção é lançada quando o usuário cancela a operação.O padrão é UICancelOption.ThrowException.Obrigatório.

Exceções

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

O caminho é uma seqüência de caracteres de comprimento zero, contém somente espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho é Nothing (ArgumentNullException).
A fonte é inválida (DirectoryNotFoundException).
A fonte é uma 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).
O arquivo já existir e o verwrite é conjunto para False (IOException).
onUserCancel é conjunto para ThrowException e um subdiretório do arquivo não pode ser copiado)IOException).
A operação é cíclica (InvalidOperationException).
Um arquivo ou nome do diretório no caminho contém dois-pontos (:) (NotSupportedException).
UICancelOption é definido como ThrowExceptione o usuário cancela a operação ou a operação não pode ser concluída ()OperationCanceledException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
UICancelOption é definida como ThrowException, e o usuário não possui permissões necessárias (SecurityException).
O usuário não tem permissão para modificar o arquivo (UnauthorizedAccessException).

Comentários

Se for feita uma tentativa de mover um diretório dentro de um diretório não existe, a estrutura de destino será criada.

Tarefas

A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Computer.FileSystem.MoveDirectory.

Para	Consulte
Para mover um diretório	Como: Mover um diretório no Visual Basic

Exemplo

Este exemplo move Directory1 interior Directory2.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

Este exemplo move Directory1 interior Directory2, substituindo o diretório se ele já existir.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

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.