FileSystem.DeleteDirectory Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.FileIO

Assemblagem:: Microsoft.VisualBasic.dll

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.

Exclui um diretório.

Sobrecargas

Name	Description
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)

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

Diretório para ser eliminado.

showUI: UIOption

Especifica se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

recycle: RecycleOption

Especifica se o ficheiro eliminado deve ou não ser enviado para o Contentor de Reciclagem. A predefinição é RecycleOption.DeletePermanently.

onUserCancel: UICancelOption

Especifica se deve lançar uma exceção se o utilizador clicar em Cancelar.

Exceções

ArgumentException

O caminho é uma cadeia de comprimento zero, está mal formada, contém apenas espaço em branco ou contém caracteres inválidos (incluindo caracteres coringa). O caminho é um caminho de dispositivo (começa por \\.\).

ArgumentNullException

directory é Nothing ou uma corda vazia.

DirectoryNotFoundException

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

IOException

Um ficheiro no diretório ou subdiretório está em uso.

NotSupportedException

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

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

SecurityException

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

OperationCanceledException

O utilizador cancela a operação ou o diretório não pode ser eliminado.

Exemplos

O exemplo apaga o diretório OldDirectory apenas se este estiver vazio.

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

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

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, pedindo ao utilizador que confirme a eliminação, mas não envia o conteúdo para o Contentor de Reciclagem.

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, enviando-os para o Contentor de Reciclagem, mas não mostra o progresso da operação.

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

Observações

Os parâmetros showUI, recycle e onUserCancel não são suportados em aplicações que não são interativas para o utilizador, como a Windows Services.

Ver também

Aplica-se a

DeleteDirectory(String, UIOption, RecycleOption)

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

Diretório para ser eliminado.

showUI: UIOption

Especifica se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

recycle: RecycleOption

Especifica se o ficheiro eliminado deve ou não ser enviado para o Contentor de Reciclagem. A predefinição é RecycleOption.DeletePermanently.

Exceções

ArgumentException

ArgumentNullException

directory é Nothing ou uma corda vazia.

DirectoryNotFoundException

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

IOException

Um ficheiro no diretório ou subdiretório está em uso.

NotSupportedException

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

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

SecurityException

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

OperationCanceledException

O utilizador cancela a operação ou o diretório não pode ser eliminado.

Exemplos

O exemplo apaga o diretório OldDirectory apenas se este estiver vazio.

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

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

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, pedindo ao utilizador que confirme a eliminação, mas não envia o conteúdo para o Contentor de Reciclagem.

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, enviando-os para o Contentor de Reciclagem, mas não mostra o progresso da operação.

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

Observações

Os parâmetros showUI e recycle não são suportados em aplicações que não sejam interativas pelo utilizador, como a Windows Services.

Ver também

Aplica-se a

DeleteDirectory(String, DeleteDirectoryOption)

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

Diretório para ser eliminado.

onDirectoryNotEmpty: DeleteDirectoryOption

Especifica o que deve ser feito quando um diretório que deve ser eliminado contém ficheiros ou diretórios. A predefinição é DeleteDirectoryOption.DeleteAllContents.

Exceções

ArgumentException

ArgumentNullException

directory é Nothing ou uma corda vazia.

DirectoryNotFoundException

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

IOException

Um ficheiro no diretório ou subdiretório está em uso.

NotSupportedException

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

PathTooLongException

O percurso excede o comprimento máximo definido pelo sistema.

SecurityException

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

OperationCanceledException

O utilizador cancela a operação ou o diretório não pode ser eliminado.

Exemplos

O exemplo apaga o diretório OldDirectory apenas se este estiver vazio.

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

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

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, pedindo ao utilizador que confirme a eliminação, mas não envia o conteúdo para o Contentor de Reciclagem.

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

Este exemplo elimina o diretório OldDirectory e todo o seu conteúdo, enviando-os para o Contentor de Reciclagem, mas não mostra o progresso da operação.

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

Ver também

DeleteDirectoryOption

Aplica-se a

Comentários

Esta página foi útil?