FileSystem.DeleteDirectory Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Exclui um diretório.

Sobrecargas

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	Exclui um diretório.
DeleteDirectory(String, UIOption, RecycleOption)	Exclui um diretório.
DeleteDirectory(String, DeleteDirectoryOption)	Exclui um diretório.

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Origem:

FileSystem.vb

Exclui um diretório.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

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

Public Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parâmetros

directory

String

O diretório a ser excluído.

showUI

UIOption

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

recycle

RecycleOption

Especifica se o arquivo excluído deve ou não ser enviado para a Lixeira. O padrão é RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Especifica se deve gerar uma exceção se o usuário clicar em Cancelar.

Exceções

ArgumentException

O caminho é uma cadeia de caracteres de tamanho zero, está malformado, contém somente espaços em branco ou caracteres inválidos (incluindo caracteres curinga). O caminho é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

directory é Nothing ou é uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório não existe ou é um arquivo.

IOException

Um arquivo do diretório ou subdiretório está em uso.

NotSupportedException

O nome do diretório contém dois-pontos (:).

PathTooLongException

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

SecurityException

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

OperationCanceledException

O usuário cancelou a operação ou o diretório não pode ser excluído.

Exemplos

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

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo.

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo, solicitando que o usuário confirme a exclusão, mas não envia o conteúdo para a 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 o conteúdo, enviando-os para a 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)

Comentários

Os showUIparâmetros , recyclee onUserCancel não têm suporte em aplicativos que não são interativos pelo usuário, como os Serviços do Windows.

Confira também

• UICancelOption
• RecycleOption
• UIOption

DeleteDirectory(String, UIOption, RecycleOption)

Origem:

FileSystem.vb

Exclui um diretório.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

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

Public Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)

Parâmetros

directory

String

O diretório a ser excluído.

showUI

UIOption

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

recycle

RecycleOption

Especifica se o arquivo excluído deve ou não ser enviado para a Lixeira. O padrão é RecycleOption.DeletePermanently.

Exceções

ArgumentException

O caminho é uma cadeia de caracteres de tamanho zero, está malformado, contém somente espaços em branco ou caracteres inválidos (incluindo caracteres curinga). O caminho é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

directory é Nothing ou é uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório não existe ou é um arquivo.

IOException

Um arquivo do diretório ou subdiretório está em uso.

NotSupportedException

O nome do diretório contém dois-pontos (:).

PathTooLongException

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

SecurityException

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

OperationCanceledException

O usuário cancelou a operação ou o diretório não pode ser excluído.

Exemplos

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

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo.

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo, solicitando que o usuário confirme a exclusão, mas não envia o conteúdo para a 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 o conteúdo, enviando-os para a 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)

Comentários

Os showUI parâmetros e recycle não têm suporte em aplicativos que não são interativos pelo usuário, como os Serviços do Windows.

Confira também

• RecycleOption
• UIOption

DeleteDirectory(String, DeleteDirectoryOption)

Origem:

FileSystem.vb

Exclui um diretório.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);

public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);

static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit

Public Shared Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)

Parâmetros

directory

String

O diretório a ser excluído.

onDirectoryNotEmpty

DeleteDirectoryOption

Especifica o que deve ser feito quando um diretório que deve ser excluído contém arquivos ou diretórios. O padrão é DeleteDirectoryOption.DeleteAllContents.

Exceções

ArgumentException

O caminho é uma cadeia de caracteres de tamanho zero, está malformado, contém somente espaços em branco ou caracteres inválidos (incluindo caracteres curinga). O caminho é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

directory é Nothing ou é uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório não existe ou é um arquivo.

IOException

Um arquivo do diretório ou subdiretório está em uso.

NotSupportedException

O nome do diretório contém dois-pontos (:).

PathTooLongException

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

SecurityException

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

OperationCanceledException

O usuário cancelou a operação ou o diretório não pode ser excluído.

Exemplos

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

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo.

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

Este exemplo exclui o diretório OldDirectory e todo o conteúdo, solicitando que o usuário confirme a exclusão, mas não envia o conteúdo para a 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 o conteúdo, enviando-os para a 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)

Confira também

• DeleteDirectoryOption