My.Computer.FileSystem.GetDirectories, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une collection de chaînes représentant les chemins d'accès de sous-répertoires présents dans un répertoire défini.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Paramètres

directory
String. Nom et chemin d'accès du répertoire. Obligatoire.
searchType
SearchOption, énumération. Inclure, ou non, les sous-dossiers. La valeur par défaut est SearchOption.SearchTopLevelOnly. Obligatoire.
wildcards
String. Modèle pour la correspondance de noms. Obligatoire.

Valeur de retour

Collection en lecture seule de String.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

Le chemin d'accès n'est pas valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ou il s'agit d'un chemin d'accès de périphérique (qui commence par \\.\) (ArgumentException).
Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).
Un ou plusieurs des caractères génériques spécifiés a la valeur Nothing, est une chaîne vide ou contient uniquement des espaces (ArgumentNullException).
directory n'existe pas (DirectoryNotFoundException).
directory pointe vers un fichier existant (IOException).
Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).
Un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).
L'utilisateur n'a pas les autorisations nécessaires (UnauthorizedAccessException).

Notes

Vous pouvez utiliser le paramètre wildcards pour spécifier un modèle spécifique. Si vous souhaitez inclure le contenu des sous-répertoires dans la recherche, affectez SearchAllSubDirectories au paramètre searchType.

Une collection vide est retournée si aucun répertoire correspondant au modèle spécifié n'est trouvé.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.GetDirectories.

Pour	Consultez
Répertorier les sous-répertoires avec un modèle spécifique	Comment : rechercher des sous-répertoires avec un modèle spécifique dans Visual Basic

Exemple

L'exemple suivant retourne tous les répertoires dans la structure de répertoire qui contiennent le mot Logs dans leurs noms et les ajoute dans ListBox1.

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

Cet exemple implique que vous disposiez dans votre formulaire d'un ListBox nommé ListBox1.

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