Metodo My.Computer.FileSystem.DeleteDirectory

Articolo
09/12/2008

Aggiornamento: novembre 2007

Elimina una directory.

' 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 _
)

Parametri

directory
String. Directory da eliminare. Obbligatorio.
onDirectoryNotEmpty
Enumerazione DeleteDirectoryOption. Specifica le azioni da intraprendere quando si deve eliminare una directory contenente file o directory. Il valore predefinito è DeleteDirectoryOption.DeleteAllContents.
showUI
Enumerazione UIOption. Specifica se eseguire il monitoraggio dell'avanzamento dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs. Obbligatorio.
recycle
Enumerazione RecycleOption. Specifica se inviare o meno il file eliminato dovrebbe essere inviato nel Cestino. Il valore predefinito è RecycleOption.DeletePermanently.
onUserCancel
Enumerazione UICancelOption. Specifica se generare un'eccezione se l'utente sceglie Annulla. Obbligatorio.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso è una stringa di lunghezza zero, contiene solo spazio bianco o caratteri non validi (compresi i caratteri jolly) (ArgumentException).
Il percorso è un percorso del dispositivo (inizia con \\.\) (ArgumentException).
Il percorso è Nothing (ArgumentNullException).
La directory non esiste o è un file (DirectoryNotFoundException).
La directory non è vuota e onDirectoryNotEmpty è impostato su ThrowIfDirectoryNonEmpty (IOException).
L'utente non dispone dell'autorizzazione richiesta per eliminare la directory o la sottodirectory (IOException).
Un file nella directory o sottodirectory è in uso (IOException).
Un file o una directory contiene i due punti (:) (NotSupportedException).
L'utente annulla l'operazione o la directory non può essere eliminata (OperationCanceledException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
L'utente non dispone delle autorizzazioni necessarie (SecurityException).

Note

I parametri showUI, recycle e onUserCancel non sono supportati nelle applicazioni che non sono interattive con l'utente come i servizi Windows.

Attività

Nella tabella riportata di seguito viene elencato un esempio di un'attività che utilizza il metodo My.Computer.FileSystem.DeleteDirectory.

Per	Vedere
Eliminare una directory	Procedura: eliminare una directory in Visual Basic

Esempio

Nell'esempio viene eliminata la directory OldDirectory solo se è vuota.

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

Nell'esempio viene eliminata la directory OldDirectory e tutto il suo contenuto.

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

Nell'esempio viene eliminata la directory OldDirectory e tutto il suo contenuto e viene richiesto all'utente di confermare l'eliminazione ma il contenuto non viene inviato nel Cestino.

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

Nell'esempio viene eliminata la directory OldDirectory e tutto il suo contenuto, inviando nel Cestino, ma non viene mostrato l'avanzamento dell'operazione.

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: la libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Potrebbero essere necessarie le autorizzazioni riportate di seguito:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
UIPermission	Consente di controllare le autorizzazioni correlate alle interfacce utente e gli Appunti. Enumerazione associata: SafeSubWindows.