Directory.EnumerateFileSystemEntries Methode
Definition
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 aufzählbare Auflistung von Dateisystemeinträgen zurück, die den angegebenen Kriterien entsprechen.
Überlädt
| Name | Beschreibung |
|---|---|
| EnumerateFileSystemEntries(String) |
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen in einem angegebenen Pfad zurück. |
| EnumerateFileSystemEntries(String, String) |
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster in einem angegebenen Pfad entsprechen. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster und Enumerationsoptionen in einem angegebenen Pfad entsprechen. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster in einem angegebenen Pfad entsprechen, und sucht optional Unterverzeichnisse. |
EnumerateFileSystemEntries(String)
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen in einem angegebenen Pfad zurück.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);static member EnumerateFileSystemEntries : string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)Parameter
- path
- String
Der relative oder absolute Pfad zum zu durchsuchenden Verzeichnis. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
Gibt zurück
Eine aufzählbare Sammlung von Dateisystemeinträgen im durch path.
Ausnahmen
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder ungültige Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.
path ist null.
path ist ungültig, z. B. auf ein nicht zugeordnetes Laufwerk.
path ist ein Dateiname.
Der angegebene Pfad, der Dateiname oder die Kombination überschreitet die vom System definierte maximale Länge.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Hinweise
Sie können relative Pfadinformationen mit dem path Parameter angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory Methode bestimmen können.
Die EnumerateFileSystemEntries Methoden GetFileSystemEntries unterscheiden sich wie folgt: Bei Verwendung EnumerateFileSystemEntrieskönnen Sie mit der Aufzählung der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Bei Verwendung GetFileSystemEntriesmüssen Sie warten, bis das gesamte Array von Einträgen zurückgegeben wird, bevor Sie auf das Array zugreifen können. Daher kann es effizienter sein, EnumerateFileSystemEntries wenn Sie mit vielen Dateien und Verzeichnissen arbeiten.
Die zurückgegebene Sammlung wird nicht zwischengespeichert. Jeder Aufruf der GetEnumerator Auflistung startet eine neue Aufzählung.
Gilt für:
EnumerateFileSystemEntries(String, String)
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster in einem angegebenen Pfad entsprechen.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);static member EnumerateFileSystemEntries : string * string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)Parameter
- path
- String
Der relative oder absolute Pfad zum zu durchsuchenden Verzeichnis. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
- searchPattern
- String
Die Suchzeichenfolge, die mit den Namen von Dateisystemeinträgen pathin abgeglichen werden soll. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Wildcardzeichen (* und ?) enthalten, unterstützt aber keine regulären Ausdrücke.
Gibt zurück
Eine aufzählbare Auflistung von Dateisystemeinträgen in dem verzeichnis, das durch path und mit dem angegebenen Suchmuster übereinstimmt.
Ausnahmen
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder ungültige Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.
-oder-
searchPattern enthält kein gültiges Muster.
path ist ungültig, z. B. auf ein nicht zugeordnetes Laufwerk.
path ist ein Dateiname.
Der angegebene Pfad, der Dateiname oder die Kombination überschreitet die vom System definierte maximale Länge.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Hinweise
searchPattern kann eine Kombination aus Literal- und Wildcardzeichen sein, aber reguläre Ausdrücke werden nicht unterstützt. Die folgenden Wildcardspezifizierer sind zulässig in searchPattern.
| Wildcardbezeichner | Treffer |
|---|---|
| * (Sternchen) | Null oder mehr Zeichen an dieser Position. |
| ? (Fragezeichen) | Genau ein Zeichen an dieser Position. |
Andere Zeichen als der Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, die path mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, die path mit dem Buchstaben "s" beginnen.
Note
Wenn Sie das Sternchen in einem searchPattern Sternchen wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung auf die Suche wie folgt aus:
- Wenn die angegebene Erweiterung genau drei Zeichen lang ist, gibt die Methode Dateien mit Erweiterungen zurück, die mit der angegebenen Erweiterung beginnen. Beispielsweise gibt "*.xls" sowohl "book.xls" als auch "book.xlsx" zurück.
- In allen anderen Fällen gibt die Methode Dateien zurück, die exakt mit der angegebenen Erweiterung übereinstimmen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".
Wenn Sie das Fragezeichen-Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Wenn Sie beispielsweise zwei Dateien haben, "file1.txt" und "file1.txtother", in einem Verzeichnis, ein Suchmuster von "Datei?.txt" gibt nur die erste Datei zurück, während ein Suchmuster von "file*.txt" beide Dateien zurückgibt.
searchPattern Darf nicht in zwei Perioden ("..") enden oder zwei Punkte ("."), gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorChar, oder dürfen sie keine ungültigen Zeichen enthalten. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars Methode abfragen.
Sie können relative Pfadinformationen mit dem path Parameter angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory Methode bestimmen können.
Die EnumerateFileSystemEntries Methoden GetFileSystemEntries unterscheiden sich wie folgt: Bei Verwendung EnumerateFileSystemEntrieskönnen Sie mit der Aufzählung der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Bei Verwendung GetFileSystemEntriesmüssen Sie warten, bis das gesamte Array von Einträgen zurückgegeben wird, bevor Sie auf das Array zugreifen können. Daher kann es effizienter sein, EnumerateFileSystemEntries wenn Sie mit vielen Dateien und Verzeichnissen arbeiten.
Die zurückgegebene Sammlung wird nicht zwischengespeichert. Jeder Aufruf der GetEnumerator Auflistung startet eine neue Aufzählung.
Gilt für:
EnumerateFileSystemEntries(String, String, EnumerationOptions)
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster und Enumerationsoptionen in einem angegebenen Pfad entsprechen.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)Parameter
- path
- String
Der relative oder absolute Pfad zum zu durchsuchenden Verzeichnis. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
- searchPattern
- String
Die Suchzeichenfolge, die mit den Namen von Dateien und Verzeichnissen in pathübereinstimmen soll. Dieser Parameter kann eine Kombination aus gültigen Literal- und Wildcardzeichen enthalten, unterstützt aber keine regulären Ausdrücke.
- enumerationOptions
- EnumerationOptions
Ein Objekt, das die zu verwendende Such- und Enumerationskonfiguration beschreibt.
Gibt zurück
Eine aufzählbare Auflistung von Dateisystemeinträgen im durch die Angegebenen pathVerzeichnis, die mit dem angegebenen Suchmuster und den angegebenen Enumerationsoptionen übereinstimmen.
Ausnahmen
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder ungültige Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.
-oder-
searchPattern enthält kein gültiges Muster.
path ist ungültig, z. B. auf ein nicht zugeordnetes Laufwerk.
path ist ein Dateiname.
Der angegebene Pfad, der Dateiname oder die Kombination überschreitet die vom System definierte maximale Länge.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Hinweise
searchPattern kann eine Kombination aus Literal- und Wildcardzeichen sein, aber reguläre Ausdrücke werden nicht unterstützt. Die folgenden Wildcardspezifizierer sind zulässig in searchPattern.
| Wildcardbezeichner | Treffer |
|---|---|
| * (Sternchen) | Null oder mehr Zeichen an dieser Position. |
| ? (Fragezeichen) | Genau ein Zeichen an dieser Position. |
Andere Zeichen als der Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, die path mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, die path mit dem Buchstaben "s" beginnen.
Note
Wenn Sie das Sternchen in einem searchPattern Sternchen wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung auf die Suche wie folgt aus:
- Wenn die angegebene Erweiterung genau drei Zeichen lang ist, gibt die Methode Dateien mit Erweiterungen zurück, die mit der angegebenen Erweiterung beginnen. Beispielsweise gibt "*.xls" sowohl "book.xls" als auch "book.xlsx" zurück.
- In allen anderen Fällen gibt die Methode Dateien zurück, die exakt mit der angegebenen Erweiterung übereinstimmen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".
Wenn Sie das Fragezeichen-Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Wenn Sie beispielsweise zwei Dateien haben, "file1.txt" und "file1.txtother", in einem Verzeichnis, ein Suchmuster von "Datei?.txt" gibt nur die erste Datei zurück, während ein Suchmuster von "file*.txt" beide Dateien zurückgibt.
searchPattern Darf nicht in zwei Perioden ("..") enden oder zwei Punkte ("."), gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorChar, oder dürfen sie keine ungültigen Zeichen enthalten. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars Methode abfragen.
Sie können relative Pfadinformationen mit dem path Parameter angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory Methode bestimmen können.
Die EnumerateFileSystemEntries Methoden GetFileSystemEntries unterscheiden sich wie folgt: Bei Verwendung EnumerateFileSystemEntrieskönnen Sie mit der Aufzählung der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Bei Verwendung GetFileSystemEntriesmüssen Sie warten, bis das gesamte Array von Einträgen zurückgegeben wird, bevor Sie auf das Array zugreifen können. Daher kann es effizienter sein, EnumerateFileSystemEntries wenn Sie mit vielen Dateien und Verzeichnissen arbeiten.
Die zurückgegebene Sammlung wird nicht zwischengespeichert. Jeder Aufruf der GetEnumerator Auflistung startet eine neue Aufzählung.
Gilt für:
EnumerateFileSystemEntries(String, String, SearchOption)
Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster in einem angegebenen Pfad entsprechen, und sucht optional Unterverzeichnisse.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)Parameter
- path
- String
Der relative oder absolute Pfad zum zu durchsuchenden Verzeichnis. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet.
- searchPattern
- String
Die Suchzeichenfolge, die mit Dateisystemeinträgen in pathübereinstimmen soll. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Wildcardzeichen (* und ?) enthalten, unterstützt aber keine regulären Ausdrücke.
- searchOption
- SearchOption
Einer der Enumerationswerte, der angibt, ob der Suchvorgang nur das aktuelle Verzeichnis enthalten soll oder alle Unterverzeichnisse enthalten soll. Der Standardwert ist TopDirectoryOnly.
Gibt zurück
Eine aufzählbare Auflistung von Dateisystemeinträgen in dem verzeichnis, das durch path und mit dem angegebenen Suchmuster und der angegebenen Option übereinstimmt.
Ausnahmen
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder ungültige Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.
-oder-
searchPattern enthält kein gültiges Muster.
searchOption ist kein gültiger SearchOption Wert.
path ist ungültig, z. B. auf ein nicht zugeordnetes Laufwerk.
path ist ein Dateiname.
Der angegebene Pfad, der Dateiname oder die Kombination überschreitet die vom System definierte maximale Länge.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Hinweise
searchPattern kann eine Kombination aus Literal- und Wildcardzeichen sein, aber reguläre Ausdrücke werden nicht unterstützt. Die folgenden Wildcardspezifizierer sind zulässig in searchPattern.
| Wildcardbezeichner | Treffer |
|---|---|
| * (Sternchen) | Null oder mehr Zeichen an dieser Position. |
| ? (Fragezeichen) | Genau ein Zeichen an dieser Position. |
Andere Zeichen als der Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, die path mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, die path mit dem Buchstaben "s" beginnen.
Note
Wenn Sie das Sternchen in einem searchPattern Sternchen wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung auf die Suche wie folgt aus:
- Wenn die angegebene Erweiterung genau drei Zeichen lang ist, gibt die Methode Dateien mit Erweiterungen zurück, die mit der angegebenen Erweiterung beginnen. Beispielsweise gibt "*.xls" sowohl "book.xls" als auch "book.xlsx" zurück.
- In allen anderen Fällen gibt die Methode Dateien zurück, die exakt mit der angegebenen Erweiterung übereinstimmen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".
Wenn Sie das Fragezeichen-Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Wenn Sie beispielsweise zwei Dateien haben, "file1.txt" und "file1.txtother", in einem Verzeichnis, ein Suchmuster von "Datei?.txt" gibt nur die erste Datei zurück, während ein Suchmuster von "file*.txt" beide Dateien zurückgibt.
searchPattern Darf nicht in zwei Perioden ("..") enden oder zwei Punkte ("."), gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorChar, oder dürfen sie keine ungültigen Zeichen enthalten. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars Methode abfragen.
Sie können relative Pfadinformationen mit dem path Parameter angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory Methode bestimmen können.
Die EnumerateFileSystemEntries Methoden GetFileSystemEntries unterscheiden sich wie folgt: Bei Verwendung EnumerateFileSystemEntrieskönnen Sie mit der Aufzählung der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Bei Verwendung GetFileSystemEntriesmüssen Sie warten, bis das gesamte Array von Einträgen zurückgegeben wird, bevor Sie auf das Array zugreifen können. Daher kann es effizienter sein, EnumerateFileSystemEntries wenn Sie mit vielen Dateien und Verzeichnissen arbeiten.
Die zurückgegebene Sammlung wird nicht zwischengespeichert. Jeder Aufruf der GetEnumerator Auflistung startet eine neue Aufzählung.