FileSystemProxy.FindInFiles Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);

public System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);

member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public 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

ReadOnlyCollection<String>

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

Ausnahmen

ArgumentException

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

ArgumentNullException

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das angegebene Verzeichnis ist nicht vorhanden.

IOException

Das angegebene Verzeichnis zeigt auf eine vorhandene Datei.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

Beispiele

In diesem Beispiel wird das Verzeichnis C:\TestDir nach dateien gesucht, die die Zeichenfolge "sample string" enthalten, und die Ergebnisse werden angezeigt 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 In list
    ListBox1.Items.Add(name)
Next

Um zu arbeiten, muss das Projekt einen ListBox benannten Namen ListBox1enthalten.

Hinweise

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.FindInFiles Methode betreffen.

Beschreibung	Siehe
Durchsuchen eines Verzeichnisses nach Dateien, die eine bestimmte Zeichenfolge enthalten	Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Siehe auch

Gilt für:

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.

public:
 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 System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);

member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public 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

ReadOnlyCollection<String>

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

Ausnahmen

ArgumentException

ArgumentNullException

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das angegebene Verzeichnis ist nicht vorhanden.

IOException

Das angegebene Verzeichnis zeigt auf eine vorhandene Datei.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

Beispiele

In diesem Beispiel wird das Verzeichnis C:\TestDir nach dateien gesucht, die die Zeichenfolge "sample string" enthalten, und die Ergebnisse werden angezeigt 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 In list
    ListBox1.Items.Add(name)
Next

Um zu arbeiten, muss das Projekt einen ListBox benannten Namen ListBox1enthalten.

Hinweise

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.FindInFiles Methode betreffen.

Beschreibung	Siehe
Durchsuchen eines Verzeichnisses nach Dateien, die eine bestimmte Zeichenfolge enthalten	Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Siehe auch

Gilt für: