Freigeben über


FileSystem.FindInFiles Methode

Definition

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien mit dem angegebenen Text darstellen.

Überlädt

FindInFiles(String, String, Boolean, SearchOption)

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien mit dem angegebenen Text darstellen.

FindInFiles(String, String, Boolean, SearchOption, String[])

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien mit dem angegebenen Text darstellen.

FindInFiles(String, String, Boolean, SearchOption)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien mit dem angegebenen Text darstellen.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);
static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

Parameter

directory
String

Das zu durchsuchende Verzeichnis.

containsText
String

Der Suchtext.

ignoreCase
Boolean

True, wenn die Groß-/Kleinschreibung bei der Suche berücksichtigt werden soll, andernfalls False. Der Standardwert ist True.

searchType
SearchOption

Gibt an, ob Unterordner eingeschlossen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly.

Gibt zurück

Eine schreibgeschützte Collection der Namen der Dateien, die den angegebenen Text enthalten.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge null; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \.</code>).

Der directory ist Nothing oder eine leere Zeichenfolge.

Das angegebene Verzeichnis ist nicht vorhanden.

Das angegebene Verzeichnis zeigt auf eine vorhandene Datei.

Der Pfad überschreitet die im System definierte maximale Länge.

Der angegebene Verzeichnispfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

In diesem Beispiel wird das Verzeichnis C:\TestDir nach Dateien durchsucht, die die Zeichenfolge "sample string" enthalten, und die Ergebnisse werden in ListBox1angezeigt.

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 In list
    ListBox1.Items.Add(name)
Next

Damit das Projekt funktioniert, muss das Projekt einen ListBox namens ListBox1enthalten.

Hinweise

Es wird eine leere Sammlung zurückgegeben, wenn keine Dateien dem angegebenen Muster entsprechen.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.FindInFiles -Methode umfasst.

Beschreibung Siehe
Search eines Verzeichnisses für Dateien, die eine bestimmte Zeichenfolge enthalten Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Weitere Informationen

Gilt für:

FindInFiles(String, String, Boolean, SearchOption, String[])

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien mit dem angegebenen Text darstellen.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);
static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)

Parameter

directory
String

Das zu durchsuchende Verzeichnis.

containsText
String

Der Suchtext.

ignoreCase
Boolean

True, wenn die Groß-/Kleinschreibung bei der Suche berücksichtigt werden soll, andernfalls False. Der Standardwert ist True.

searchType
SearchOption

Gibt an, ob Unterordner eingeschlossen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly.

fileWildcards
String[]

Das Muster, das übereinstimmen muss.

Gibt zurück

Eine schreibgeschützte Collection der Namen der Dateien, die den angegebenen Text enthalten.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge null; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \.</code>).

Der directory ist Nothing oder eine leere Zeichenfolge.

Das angegebene Verzeichnis ist nicht vorhanden.

Das angegebene Verzeichnis zeigt auf eine vorhandene Datei.

Der Pfad überschreitet die im System definierte maximale Länge.

Der angegebene Verzeichnispfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

In diesem Beispiel wird das Verzeichnis C:\TestDir nach Dateien durchsucht, die die Zeichenfolge "sample string" enthalten, und die Ergebnisse werden in ListBox1angezeigt.

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 In list
    ListBox1.Items.Add(name)
Next

Damit das Projekt funktioniert, muss das Projekt einen ListBox namens ListBox1enthalten.

Hinweise

Es wird eine leere Sammlung zurückgegeben, wenn keine Dateien dem angegebenen Muster entsprechen.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.FindInFiles -Methode umfasst.

Beschreibung Siehe
Search eines Verzeichnisses für Dateien, die eine bestimmte Zeichenfolge enthalten Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Weitere Informationen

Gilt für: