My.Computer.FileSystem.FindInFiles, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une collection en lecture seule de chaînes qui représentent les noms des fichiers contenant le texte spécifié.

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

Paramètres

Directory
String. Répertoire à rechercher. Obligatoire.
containsText
String. Texte de recherche. Obligatoire.
ignoreCase
Boolean. Si la recherche doit respecter ou non la casse. La valeur par défaut est True. Obligatoire.
searchType
SearchOption, énumération. Inclure, ou non, les sous-dossiers. La valeur par défaut est SearchOption.SearchTopLevelOnly. Obligatoire.
fileWildcards
Tableau de type String. Modèle à faire correspondre. Obligatoire.

Valeur de retour

Collection en lecture seule de type 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).
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

Une collection vide est retournée si aucun fichier 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.FindInFiles.

Pour	Consultez
Rechercher dans un répertoire des fichiers contenant une chaîne spécifique	Procédure pas à pas : manipulation de fichiers et de répertoires en Visual Basic

Exemple

Cet exemple recherche dans le répertoire C:\TestDir des fichiers contenant la chaîne "sample string" et affiche les résultats dans ListBox1.

Dim list As System.Collections.ObjectModel.ReadOnlyCollection _
(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", _
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name As String In list
    ListBox1.Items.Add(name)
Next

Pour que cet exemple fonctionne, le projet doit contenir un ListBox nommé ListBox1.

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque Visual Basic Runtime (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