Directory.EnumerateFileSystemEntries Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Gibt eine aufzählbare Auflistung von Dateisystemeinträgen zurück, die bestimmte Kriterien erfüllen.

Überlädt

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. Optional werden Unterverzeichnisse durchsucht.

EnumerateFileSystemEntries(String)

Quelle:

Directory.cs

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 Verzeichnis, das durchsucht werden soll. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht berücksichtigt.

Gibt zurück

IEnumerable<String>

Eine aufzählbare Auflistung von Dateisystemeinträgen im von path angegebenen Verzeichnis.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

DirectoryNotFoundException

path ist ungültig (verweist z. B. auf ein nicht zugeordnetes Laufwerk).

IOException

path ist ein Dateiname.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Sie können relative Pfadinformationen mit dem path -Parameter angeben. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory -Methode ermitteln können.

Die EnumerateFileSystemEntries Methoden und GetFileSystemEntries unterscheiden sich wie folgt: Wenn Sie verwenden EnumerateFileSystemEntries, können Sie mit dem Aufzählen der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Wenn Sie verwenden GetFileSystemEntries, mü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 Auflistung wird nicht zwischengespeichert. Jeder Aufruf von für GetEnumerator die Auflistung startet eine neue Enumeration.

EnumerateFileSystemEntries(String, String)

Quelle:

Directory.cs

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 Verzeichnis, das durchsucht werden soll. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht berücksichtigt.

searchPattern

String

Die Suchzeichenfolge für die Überprüfung der Namen von Dateisystemeinträgen in path auf Übereinstimmungen. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.

Gibt zurück

IEnumerable<String>

Eine aufzählbare Auflistung von Dateisystemeinträgen, die sich in dem von path angegebenen Verzeichnis befinden und dem angegebenen Suchmuster entsprechen.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

- oder -

searchPattern enthält kein gültiges Muster.

ArgumentNullException

path ist null.

- oder -

searchPattern ist null.

DirectoryNotFoundException

path ist ungültig (verweist z. B. auf ein nicht zugeordnetes Laufwerk).

IOException

path ist ein Dateiname.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt. Die folgenden Wildcardspezifizierer sind in searchPatternzulässig.

Wildcard-Spezifizierer	Treffer
* (Sternchen)	Null oder mehr Zeichen an dieser Position.
? (Fragezeichen)	Genau ein Zeichen an dieser Position.

Andere Zeichen als das Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, path die mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, path die mit dem Buchstaben "s" beginnen.

Hinweis

Wenn Sie das Sternchen in einem searchPattern wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung wie folgt auf die Suche 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 genau der angegebenen Erweiterung entsprechen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".

Wenn Sie das Fragezeichen als Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Bei zwei Dateien , "file1.txt" und "file1.txtother", in einem Verzeichnis gibt das Suchmuster "file?.txt" nur die erste Datei zurück, während das Suchmuster "file*.txt" beide Dateien zurückgibt.

searchPattern darf nicht mit zwei Punkten ("..") enden oder zwei Punkte ("..") gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorCharenthalten, noch darf er ungültige Zeichen enthalten. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars-Methode ausführen.

Sie können relative Pfadinformationen mit dem path -Parameter angeben. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory -Methode ermitteln können.

Die EnumerateFileSystemEntries Methoden und GetFileSystemEntries unterscheiden sich wie folgt: Wenn Sie verwenden EnumerateFileSystemEntries, können Sie mit dem Aufzählen der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Wenn Sie verwenden GetFileSystemEntries, mü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 Auflistung wird nicht zwischengespeichert. Jeder Aufruf von für GetEnumerator die Auflistung startet eine neue Enumeration.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Quelle:

Directory.cs

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 Verzeichnis, das durchsucht werden soll. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht berücksichtigt.

searchPattern

String

Die Suchzeichenfolge für die Überprüfung der Namen von Dateien und Verzeichnissen in path auf Übereinstimmungen. Dieser Parameter kann eine Kombination aus gültigen Literal- und Platzhalterzeichen enthalten, unterstützt jedoch keine regulären Ausdrücke.

enumerationOptions

EnumerationOptions

Ein Objekt, das die zu verwendende Such- und Enumerationskonfiguration beschreibt.

Gibt zurück

IEnumerable<String>

Eine aufzählbare Auflistung von Dateisystemeinträgen, die sich in dem von path angegebenen Verzeichnis befinden und dem angegebenen Suchmuster und den angegebenen Enumerationsoptionen entsprechen.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

- oder -

searchPattern enthält kein gültiges Muster.

ArgumentNullException

path ist null.

- oder -

searchPattern ist null.

ArgumentOutOfRangeException

searchOption ist kein gültiger SearchOption -Wert.

DirectoryNotFoundException

path ist ungültig (verweist z. B. auf ein nicht zugeordnetes Laufwerk).

IOException

path ist ein Dateiname.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt. Die folgenden Wildcardspezifizierer sind in searchPatternzulässig.

Wildcard-Spezifizierer	Treffer
* (Sternchen)	Null oder mehr Zeichen an dieser Position.
? (Fragezeichen)	Genau ein Zeichen an dieser Position.

Andere Zeichen als das Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, path die mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, path die mit dem Buchstaben "s" beginnen.

Hinweis

Wenn Sie das Sternchen in einem searchPattern wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung wie folgt auf die Suche 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 genau der angegebenen Erweiterung entsprechen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".

Wenn Sie das Fragezeichen als Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Bei zwei Dateien , "file1.txt" und "file1.txtother", in einem Verzeichnis gibt das Suchmuster "file?.txt" nur die erste Datei zurück, während das Suchmuster "file*.txt" beide Dateien zurückgibt.

searchPattern darf nicht mit zwei Punkten ("..") enden oder zwei Punkte ("..") gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorCharenthalten, noch darf er ungültige Zeichen enthalten. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars-Methode ausführen.

Sie können relative Pfadinformationen mit dem path -Parameter angeben. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory -Methode ermitteln können.

Die EnumerateFileSystemEntries Methoden und GetFileSystemEntries unterscheiden sich wie folgt: Wenn Sie verwenden EnumerateFileSystemEntries, können Sie mit dem Aufzählen der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Wenn Sie verwenden GetFileSystemEntries, mü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 Auflistung wird nicht zwischengespeichert. Jeder Aufruf von für GetEnumerator die Auflistung startet eine neue Enumeration.

EnumerateFileSystemEntries(String, String, SearchOption)

Quelle:

Directory.cs

Gibt eine aufzählbare Auflistung von Dateinamen und Verzeichnisnamen zurück, die einem Suchmuster in einem angegebenen Pfad entsprechen. Optional werden Unterverzeichnisse durchsucht.

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 Verzeichnis, das durchsucht werden soll. Bei dieser Zeichenfolge wird die Groß-/Kleinschreibung nicht berücksichtigt.

searchPattern

String

Die Suchzeichenfolge für die Überprüfung von Dateisystemeinträgen in path auf Übereinstimmungen. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.

searchOption

SearchOption

Einer der Enumerationswerte, der angibt, ob nur das aktuelle Verzeichnis oder auch alle Unterverzeichnisse durchsucht werden sollen. Der Standardwert ist TopDirectoryOnly.

Gibt zurück

IEnumerable<String>

Eine aufzählbare Auflistung von Dateisystemeinträgen, die sich in dem von path angegebenen Verzeichnis befinden und dem angegebenen Suchmuster und der angegebenen Option entsprechen.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

- oder -

searchPattern enthält kein gültiges Muster.

ArgumentNullException

path ist null.

- oder -

searchPattern ist null.

ArgumentOutOfRangeException

searchOption ist kein gültiger SearchOption -Wert.

DirectoryNotFoundException

path ist ungültig (verweist z. B. auf ein nicht zugeordnetes Laufwerk).

IOException

path ist ein Dateiname.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt. Die folgenden Wildcardspezifizierer sind in searchPatternzulässig.

Wildcard-Spezifizierer	Treffer
* (Sternchen)	Null oder mehr Zeichen an dieser Position.
? (Fragezeichen)	Genau ein Zeichen an dieser Position.

Andere Zeichen als das Wildcard sind Literalzeichen. Beispielsweise sucht die searchPattern Zeichenfolge "*t" nach allen Namen, path die mit dem Buchstaben "t" enden. Die searchPattern Zeichenfolge "s*" sucht nach allen Namen, path die mit dem Buchstaben "s" beginnen.

Hinweis

Wenn Sie das Sternchen in einem searchPattern wie "*.txt" verwenden, wirkt sich die Anzahl der Zeichen in der angegebenen Erweiterung wie folgt auf die Suche 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 genau der angegebenen Erweiterung entsprechen. Beispielsweise gibt "*.ai" "file.ai" zurück, aber nicht "file.aif".

Wenn Sie das Fragezeichen als Wildcardzeichen verwenden, gibt diese Methode nur Dateien zurück, die der angegebenen Dateierweiterung entsprechen. Bei zwei Dateien , "file1.txt" und "file1.txtother", in einem Verzeichnis gibt das Suchmuster "file?.txt" nur die erste Datei zurück, während das Suchmuster "file*.txt" beide Dateien zurückgibt.

searchPattern darf nicht mit zwei Punkten ("..") enden oder zwei Punkte ("..") gefolgt von DirectorySeparatorChar oder AltDirectorySeparatorCharenthalten, noch darf er ungültige Zeichen enthalten. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars-Methode ausführen.

Sie können relative Pfadinformationen mit dem path -Parameter angeben. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert, das Sie mithilfe der GetCurrentDirectory -Methode ermitteln können.

Die EnumerateFileSystemEntries Methoden und GetFileSystemEntries unterscheiden sich wie folgt: Wenn Sie verwenden EnumerateFileSystemEntries, können Sie mit dem Aufzählen der Auflistung von Einträgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. Wenn Sie verwenden GetFileSystemEntries, mü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 Auflistung wird nicht zwischengespeichert. Jeder Aufruf von für GetEnumerator die Auflistung startet eine neue Enumeration.