My.Computer.FileSystem.DeleteDirectory, méthode
Mise à jour : novembre 2007
Supprime un répertoire.
' 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 _
)
Paramètres
directory
String. Répertoire à supprimer. Obligatoire.onDirectoryNotEmpty
Énumération DeleteDirectoryOption. Spécifie l'opération à effectuer lorsqu'un répertoire à supprimer contient des fichiers ou des répertoires. La valeur par défaut est DeleteDirectoryOption.DeleteAllContents.showUI
Énumération UIOption. Spécifie s'il faut effectuer un suivi visuel de l'avancement de l'opération. La valeur par défaut est UIOption.OnlyErrorDialogs. Obligatoire.recycle
Énumération RecycleOption. Spécifie si le fichier supprimé doit être ou non envoyé à la Corbeille. La valeur par défaut est RecycleOption.DeletePermanently.onUserCancel
Énumération UICancelOption. Spécifie s'il convient de lever une exception si l'utilisateur clique sur Annuler. Obligatoire.
Exceptions
Les conditions ci-dessous peuvent générer une exception :
Le chemin d'accès est une chaîne de longueur nulle, est incorrect, se compose uniquement d'un espace blanc ou contient des caractères incorrects (y compris des caractères génériques) (ArgumentException).
Le chemin d'accès est un chemin de périphérique (commence par \\. \) (ArgumentException).
Le chemin d'accès est Nothing (ArgumentNullException).
Le répertoire n'existe pas ou est un fichier (DirectoryNotFoundException).
Le répertoire n'est pas vide, et onDirectoryNotEmpty a la valeur ThrowIfDirectoryNonEmpty (IOException).
L'utilisateur n'a pas l'autorisation de supprimer le répertoire ou le sous-répertoire (IOException).
Un fichier du répertoire ou du sous-répertoire est en cours d'utilisation (IOException).
Un nom de fichier ou de répertoire contient le signe deux-points (:) (NotSupportedException).
L'utilisateur annule l'opération ou le répertoire ne peut pas être supprimé (OperationCanceledException).
Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).
L'utilisateur n'a pas les autorisations requises (SecurityException).
Notes
Les paramètres showUI, recycle et onUserCancel ne sont pas pris en charge dans les applications qui ne sont pas en mode utilisateur intéractif, telles que les services Windows.
Tâches
Le tableau suivant répertorie un exemple de tâche impliquant la méthode My.Computer.FileSystem.DeleteDirectory.
Pour |
Reportez-vous à |
---|---|
Supprimer un répertoire |
Exemple
L'exemple supprime le répertoire OldDirectory uniquement s'il est vide.
My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)
Cet exemple supprime le répertoire OldDirectory et tout son contenu.
My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.DeleteAllContents)
Cet exemple supprime le répertoire OldDirectory et tout son contenu et demande à l'utilisateur de confirmer la suppression, mais n'envoie pas le contenu à la Corbeille.
My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.DeletePermanently, FileIO.UICancelOption.ThrowException)
Cet exemple supprime le répertoire OldDirectory et tout son contenu et les envoie à la Corbeille, mais n'affiche pas l'avancement de l'opération.
My.Computer.FileSystem.DeleteDirectory("C:\OldDirectory", _
FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)
Configuration requise
Espace de noms :Microsoft.VisualBasic.MyServices
Classe :FileSystemProxy (fournit l'accès à FileSystem)
Assembly : bibliothèque Runtime Visual Basic (dans Microsoft.VisualBasic.dll)
Disponibilité par type de projet
Type de projet |
Disponible |
---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Oui |
Application console |
Oui |
Bibliothèque de contrôles Windows |
Oui |
Bibliothèque de contrôles Web |
Oui |
Service Windows |
Oui |
Site Web |
Oui |
Autorisations
Les autorisations suivantes peuvent être nécessaires :
Autorisation |
Description |
---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
|
Contrôle les autorisations relatives aux interfaces utilisateur et au Presse-papiers. Énumération associée : SafeSubWindows. |
Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.
Voir aussi
Tâches
Comment : supprimer un fichier dans Visual Basic
Comment : supprimer un répertoire dans Visual Basic