Método My.Computer.FileSystem.DeleteDirectory

Artigo
08/25/2010

Exclui um Diretório.

' Usage
My.Computer.FileSystem.DeleteDirectory(directory ,onDirectoryNotEmpty)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal onDirectoryNotEmpty As DeleteDirectoryOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

directory
String.Diretório a ser excluído.Obrigatório.
onDirectoryNotEmpty
Enumeração DeleteDirectoryOption.Especifica o que deve ser feito quando um diretório que está para ser excluído contém arquivos ou diretórios.O padrão é DeleteDirectoryOption.DeleteAllContents.
showUI
Enumeração UIOption.Especifica se deve ser rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
recycle
Enumeração RecycleOption.Especifica se o arquivo excluído deve ser enviado para o Da Lixeira.O padrão é RecycleOption.DeletePermanently.
onUserCancel
Enumeração UICancelOption.Especifica se deve lançar uma exceção se o usuário clicar em Cancelar.Obrigatório.

Exceções

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

O caminho é uma sequência de caracteres de comprimento zero, está malformado, contém somente espaços em branco, ou contém caracteres inválidos (incluindo caracteres curinga)(ArgumentException).
O caminho é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho é Nothing (ArgumentNullException).
O diretório não existe ou é um arquivo (DirectoryNotFoundException).
O diretório não está vazio e onDirectoryNotEmpty é definido como ThrowIfDirectoryNonEmpty (IOException).
O usuário não tem permissão para excluir o diretório ou subdiretório (IOException).
Um arquivo no diretório ou subdiretório está em uso (IOException).
Um arquivo ou nome do diretório contém dois-pontos (:) (NotSupportedException).
O usuário cancela a operação ou o diretório não pode ser excluído (OperationCanceledException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
O usuário não tem as permissões necessárias (SecurityException).

Comentários

Os parâmetros showUI,recycle, e onUserCancel não são suportados em aplicativos que não forem interativos com o usuário, como serviços do Windows.

Tarefas

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

Para	Consulte
Excluir um Diretório.	Como: Excluir um diretório no Visual Basic

Exemplo

O exemplo exclui o diretório OldDirectory somente se estiver vazio.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

Este exemplo exclui o diretório OldDirectory e todo seu Sumário.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.DeleteAllContents)

Este exemplo exclui o diretório OldDirectory e todos os seu Sumário, perguntando ao usuário para confirmar a exclusão, mas não envia o Sumário para o Da Lixeira.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.DeletePermanently, FileIO.UICancelOption.ThrowException)

Este exemplo exclui o diretório OldDirectory e todo seu Sumário, enviando-as para o Da Lixeira, mas não mostra o progresso da operação.

My.Computer.FileSystem.DeleteDirectory("C:\OldDirectory", _
 FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

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.