Partager via


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

Comment : supprimer un répertoire dans Visual Basic

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

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

UIPermission

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

Référence

My.Computer.FileSystem, objet

UICancelOption, énumération

FileSystem.DeleteDirectory

UICancelOption

RecycleOption, énumération

DeleteDirectoryOption, énumération

UICancelOption, énumération

UIOption, énumération