My.Computer.FileSystem.FindInFiles-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien darstellt und den angegebenen Text enthält.

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

Parameter

Directory
String. Das zu durchsuchende Verzeichnis. Erforderlich.
containsText
String. Der Suchtext. Erforderlich.
ignoreCase
Boolean. Ob bei der Suche die Groß-/Kleinschreibung beachtet werden soll. Der Standardwert ist True. Erforderlich.
searchType
SearchOption-Enumeration. Ob Unterordner einbezogen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly. Erforderlich.
fileWildcards
Array vom Typ String. Das zu vergleichende Muster. Erforderlich.

Rückgabewert

Schreibgeschützte Auflistung vom Typ String.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
directory ist nicht vorhanden (DirectoryNotFoundException).
directory zeigt auf eine vorhandene Datei (IOException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen (UnauthorizedAccessException).

Hinweise

Wenn keine Dateien gefunden werden, die mit dem angegebenen Muster übereinstimmen, wird eine leere Auflistung zurückgegeben.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.FindInFiles-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Durchsuchen eines Verzeichnisses nach Dateien, die eine bestimmte Zeichenfolge enthalten	Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Beispiel

In diesem Beispiel wird das Verzeichnis C:\TestDir nach Dateien durchsucht, die die Zeichenfolge "sample string" enthalten, und das Ergebnis in ListBox1 angezeigt.

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

Damit das Projekt ausgeführt werden kann, muss es ein ListBox mit dem Namen ListBox1 enthalten.