FileSystemProxy.DeleteDirectory Método

Definição

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

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)	Exclui um diretório.
DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	Exclui um diretório.
DeleteDirectory(String, DeleteDirectoryOption)	Exclui um diretório.

DeleteDirectory(String, UIOption, RecycleOption)

Exclui um diretório.

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

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

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

Public 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

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 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, UIOption, RecycleOption, UICancelOption)

Exclui um diretório.

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

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

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

Public 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

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, DeleteDirectoryOption)

Exclui um diretório.

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

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

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

Public 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

Aplica-se a

Comentários

Esta página foi útil?