FileSystem.FindInFiles Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

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

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

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

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

• SearchOption
• ReadOnlyCollection<T>

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

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

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

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

• SearchOption
• ReadOnlyCollection<T>