DirectoryInfo.EnumerateDirectories Methode

Definition

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen im aktuellen Verzeichnis zurück.Returns an enumerable collection of directory information in the current directory.

Überlädt

EnumerateDirectories(String, SearchOption)

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster und einer angegebenen Option zum Durchsuchen von Unterverzeichnissen entspricht.Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option.

EnumerateDirectories(String, EnumerationOptions)

Gibt eine aufzählbare Sammlung von Verzeichnisinformationen zurück, die dem angegebenen Suchmuster und der angegebenen Option entsprichtReturns an enumerable collection of directory information that matches the specified search pattern and enumeration options.

EnumerateDirectories()

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen im aktuellen Verzeichnis zurück.Returns an enumerable collection of directory information in the current directory.

EnumerateDirectories(String)

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster entsprechen.Returns an enumerable collection of directory information that matches a specified search pattern.

EnumerateDirectories(String, SearchOption)

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster und einer angegebenen Option zum Durchsuchen von Unterverzeichnissen entspricht.Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option.

public:
 System::Collections::Generic::IEnumerable<System::IO::DirectoryInfo ^> ^ EnumerateDirectories(System::String ^ searchPattern, System::IO::SearchOption searchOption);
public System.Collections.Generic.IEnumerable<System.IO.DirectoryInfo> EnumerateDirectories (string searchPattern, System.IO.SearchOption searchOption);
member this.EnumerateDirectories : string * System.IO.SearchOption -> seq<System.IO.DirectoryInfo>

Parameter

searchPattern
String

Die Suchzeichenfolge für die Überprüfung der Namen von Verzeichnissen auf Übereinstimmungen.The search string to match against the names of directories. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption

Einer der Enumerationswerte, der angibt, ob nur das aktuelle Verzeichnis oder auch alle Unterverzeichnisse durchsucht werden sollen.One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories. Der Standardwert ist TopDirectoryOnly.The default value is TopDirectoryOnly.

Gibt zurück

Eine aufzählbare Auflistung von Verzeichnissen, die searchPattern und searchOption entspricht.An enumerable collection of directories that matches searchPattern and searchOption.

Ausnahmen

searchPattern ist null.searchPattern is null.

searchOption ist kein gültiger SearchOption-Wert.searchOption is not a valid SearchOption value.

Der im DirectoryInfo-Objekt gekapselte Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Beispiel, beginnend bei einem angegebenen Verzeichnis, werden diese Methode und die EnumerateFiles-Methode verwendet, um die Dateien und Verzeichnisse im Start Verzeichnis aufzulisten und Details von Dateien mit einer Größe von mehr als 10 MB anzuzeigen.The following example, starting from a specified directory, uses this method and the EnumerateFiles method to enumerate the files and directories within the start directory and display details of any files over 10 MB in size.

using System;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        // Set a variable to the My Documents path.
        string docPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

        DirectoryInfo diTop = new DirectoryInfo(docPath);

        try
        {
            foreach (var fi in diTop.EnumerateFiles())
            {
                try
                {
                    // Display each file over 10 MB;
                    if (fi.Length > 10000000)
                    {
                        Console.WriteLine($"{fi.FullName}\t\t{fi.Length.ToString("NO")}");
                    }
                }
                catch (UnauthorizedAccessException unAuthTop)
                {
                    Console.WriteLine($"{unAuthTop.Message}");
                }
            }
            
            foreach (var di in diTop.EnumerateDirectories("*"))
            {
                try
                {
                    foreach (var fi in di.EnumerateFiles("*", SearchOption.AllDirectories))
                    {
                        try
                        {
                            // Display each file over 10 MB;
                            if (fi.Length > 10000000)
                            {
                                Console.WriteLine($"{fi.FullName}\t\t{fi.Length.ToString("NO")}");
                            }
                        }
                        catch (UnauthorizedAccessException unAuthFile)
                        {
                            Console.WriteLine($"unAuthFile: {unAuthFile.Message}");
                        }
                    }
                }
                catch (UnauthorizedAccessException unAuthSubDir)
                {
                    Console.WriteLine($"unAuthSubDir: {unAuthSubDir.Message}");
                }
            }
        }
        catch (DirectoryNotFoundException dirNotFound)
        {
            Console.WriteLine($"{dirNotFound.Message}");
        }
        catch (UnauthorizedAccessException unAuthDir)
        {
            Console.WriteLine($"unAuthDir: {unAuthDir.Message}");
        }
        catch (PathTooLongException longPath)
        {
            Console.WriteLine($"{longPath.Message}");
        }
    }
}
Imports System.IO

Class Program
    Public Shared Sub Main(ByVal args As String())
        Dim dirPath As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
        Dim diTop As New DirectoryInfo(dirPath)
        Try
            For Each fi In diTop.EnumerateFiles()
                Try
                    ' Display each file over 10 MB;
                    If fi.Length > 10000000 Then
                        Console.WriteLine("{0}" & vbTab & vbTab & "{1}", fi.FullName, fi.Length.ToString("N0"))
                    End If
                Catch unAuthTop As UnauthorizedAccessException
                    Console.WriteLine($"{unAuthTop.Message}")
                End Try
            Next

            For Each di In diTop.EnumerateDirectories("*")
                Try
                    For Each fi In di.EnumerateFiles("*", SearchOption.AllDirectories)
                        Try
                            ' // Display each file over 10 MB;
                            If fi.Length > 10000000 Then
                                Console.WriteLine("{0}" & vbTab &
                                vbTab & "{1}", fi.FullName, fi.Length.ToString("N0"))
                            End If
                        Catch unAuthFile As UnauthorizedAccessException
                            Console.WriteLine($"unAuthFile: {unAuthFile.Message}")
                        End Try
                    Next
                Catch unAuthSubDir As UnauthorizedAccessException
                    Console.WriteLine($"unAuthSubDir: {unAuthSubDir.Message}")
                End Try
            Next
        Catch dirNotFound As DirectoryNotFoundException
            Console.WriteLine($"{dirNotFound.Message}")
        Catch unAuthDir As UnauthorizedAccessException
            Console.WriteLine($"unAuthDir: {unAuthDir.Message}")
        Catch longPath As PathTooLongException
            Console.WriteLine($"{longPath.Message}")
        End Try
    End Sub
End Class

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Die folgenden Platzhalter spezifiatoren sind in searchPatternzulässig.The following wildcard specifiers are permitted in searchPattern.

Platzhalter BezeichnerWildcard specifier ÜbereinstimmungenMatches
* (Sternchen)* (asterisk) NULL oder mehr Zeichen an dieser Position.Zero or more characters in that position.
?? (Fragezeichen)(question mark) NULL oder ein Zeichen an dieser Position.Zero or one character in that position.

Andere Zeichen als der Platzhalter sind Literalzeichen.Characters other than the wildcard are literal characters. Die Zeichenfolge "*t" sucht z. b. nach allen Namen, die mit dem Buchstaben "t" enden.For example, the string "*t" searches for all names in ending with the letter "t". ".". Die searchPattern Zeichenfolge "s*" sucht nach allen Namen in path beginnend mit dem Buchstaben "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Die Methoden EnumerateDirectories und GetDirectories unterscheiden sich wie folgt:The EnumerateDirectories and GetDirectories methods differ as follows:

  • Wenn Sie EnumerateDirectoriesverwenden, können Sie mit dem Auflisten der Auflistung von DirectoryInfo Objekten beginnen, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Wenn Sie GetDirectoriesverwenden, müssen Sie warten, bis das gesamte Array von DirectoryInfo Objekten zurückgegeben wird, bevor Sie auf das Array zugreifen können.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Wenn Sie also mit vielen Dateien und Verzeichnissen arbeiten, können EnumerateDirectories effizienter sein.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Diese Methode füllt die Werte der folgenden DirectoryInfo Eigenschaften vorab auf:This method pre-populates the values of the following DirectoryInfo properties:

Die zurückgegebene Auflistung wird nicht zwischengespeichert. jeder aufzurufende GetEnumerator-Methode für die Auflistung startet eine neue-Enumeration.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

EnumerateDirectories(String, EnumerationOptions)

Gibt eine aufzählbare Sammlung von Verzeichnisinformationen zurück, die dem angegebenen Suchmuster und der angegebenen Option entsprichtReturns an enumerable collection of directory information that matches the specified search pattern and enumeration options.

public:
 System::Collections::Generic::IEnumerable<System::IO::DirectoryInfo ^> ^ EnumerateDirectories(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);
public System.Collections.Generic.IEnumerable<System.IO.DirectoryInfo> EnumerateDirectories (string searchPattern, System.IO.EnumerationOptions enumerationOptions);
member this.EnumerateDirectories : string * System.IO.EnumerationOptions -> seq<System.IO.DirectoryInfo>

Parameter

searchPattern
String

Die Suchzeichenfolge für die Überprüfung der Namen von Verzeichnissen auf Übereinstimmungen.The search string to match against the names of directories. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

enumerationOptions
EnumerationOptions

Ein Objekt, das die zu verwendende Such- und Enumerationskonfiguration beschreibt.An object that describes the search and enumeration configuration to use.

Gibt zurück

Eine aufzählbare Auflistung von Verzeichnissen, die searchPattern und enumerationOptions entspricht.An enumerable collection of directories that matches searchPattern and enumerationOptions.

Ausnahmen

searchPattern ist null.searchPattern is null.

Der im DirectoryInfo-Objekt gekapselte Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Die folgenden Platzhalter spezifiatoren sind in searchPatternzulässig.The following wildcard specifiers are permitted in searchPattern.

Platzhalter BezeichnerWildcard specifier ÜbereinstimmungenMatches
* (Sternchen)* (asterisk) NULL oder mehr Zeichen an dieser Position.Zero or more characters in that position.
?? (Fragezeichen)(question mark) NULL oder ein Zeichen an dieser Position.Zero or one character in that position.

Andere Zeichen als der Platzhalter sind Literalzeichen.Characters other than the wildcard are literal characters. Die Zeichenfolge "*t" sucht z. b. nach allen Namen, die mit dem Buchstaben "t" enden.For example, the string "*t" searches for all names in ending with the letter "t". ".". Die searchPattern Zeichenfolge "s*" sucht nach allen Namen in path beginnend mit dem Buchstaben "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Die Methoden EnumerateDirectories und GetDirectories unterscheiden sich wie folgt:The EnumerateDirectories and GetDirectories methods differ as follows:

  • Wenn Sie EnumerateDirectoriesverwenden, können Sie mit dem Auflisten der Auflistung von DirectoryInfo Objekten beginnen, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Wenn Sie GetDirectoriesverwenden, müssen Sie warten, bis das gesamte Array von DirectoryInfo Objekten zurückgegeben wird, bevor Sie auf das Array zugreifen können.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Wenn Sie also mit vielen Dateien und Verzeichnissen arbeiten, können EnumerateDirectories effizienter sein.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Diese Methode füllt die Werte der folgenden DirectoryInfo Eigenschaften vorab auf:This method pre-populates the values of the following DirectoryInfo properties:

Die zurückgegebene Auflistung wird nicht zwischengespeichert. jeder aufzurufende GetEnumerator-Methode für die Auflistung startet eine neue-Enumeration.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

EnumerateDirectories()

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen im aktuellen Verzeichnis zurück.Returns an enumerable collection of directory information in the current directory.

public:
 System::Collections::Generic::IEnumerable<System::IO::DirectoryInfo ^> ^ EnumerateDirectories();
public System.Collections.Generic.IEnumerable<System.IO.DirectoryInfo> EnumerateDirectories ();
member this.EnumerateDirectories : unit -> seq<System.IO.DirectoryInfo>
Public Function EnumerateDirectories () As IEnumerable(Of DirectoryInfo)

Gibt zurück

Eine aufzählbare Auflistung der Verzeichnisse im aktuellen Verzeichnis.An enumerable collection of directories in the current directory.

Ausnahmen

Der im DirectoryInfo-Objekt gekapselte Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Beispiel werden die Unterverzeichnisse unter dem Verzeichnis "c:\Program Files" aufgelistet, und es wird eine LINQ-Abfrage verwendet, um die Namen aller Verzeichnisse zurückzugeben, die vor 2009 erstellt wurden, indem der Wert der CreationTimeUtc-Eigenschaft überprüft wird.The following example enumerates the subdirectories under the C:\Program Files directory and uses a LINQ query to return the names of all directories that were created before 2009 by checking the value of the CreationTimeUtc property.

Wenn Sie nur die Namen der Unterverzeichnisse benötigen, verwenden Sie die statische Directory-Klasse, um die Leistung zu verbessern.If you only need the names of the subdirectories, use the static Directory class for better performance. Ein Beispiel finden Sie in der EnumerateDirectories(String)-Methode.For an example, see the EnumerateDirectories(String) method.

using System;
using System.IO;

namespace EnumDir
{
    class Program
    {
        static void Main(string[] args)
        {
            // Set a variable to the Documents path.
            string docPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

            DirectoryInfo dirPrograms = new DirectoryInfo(docPath);
            DateTime StartOf2009 = new DateTime(2009, 01, 01);

            var dirs = from dir in dirPrograms.EnumerateDirectories()
            where dir.CreationTimeUtc > StartOf2009
            select new
            {
                ProgDir = dir,
            };

            foreach (var di in dirs)
            {
                Console.WriteLine($"{di.ProgDir.Name}");
            }
        }
    }
}
// </Snippet1>
Imports System.IO

Module Module1

    Sub Main()

        Dim dirPath As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
        Dim dirPrograms As New DirectoryInfo(dirPath)
        Dim StartOf2009 As New DateTime(2009, 1, 1)

        Dim dirs = From dir In dirPrograms.EnumerateDirectories()
                   Where dir.CreationTimeUtc > StartOf2009

        For Each di As DirectoryInfo In dirs
            Console.WriteLine("{0}", di.Name)
        Next

    End Sub

End Module

Hinweise

Die Methoden EnumerateDirectories und GetDirectories unterscheiden sich wie folgt:The EnumerateDirectories and GetDirectories methods differ as follows:

  • Wenn Sie EnumerateDirectoriesverwenden, können Sie mit dem Auflisten der Auflistung von DirectoryInfo Objekten beginnen, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Wenn Sie GetDirectoriesverwenden, müssen Sie warten, bis das gesamte Array von DirectoryInfo Objekten zurückgegeben wird, bevor Sie auf das Array zugreifen können.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Wenn Sie also mit vielen Dateien und Verzeichnissen arbeiten, können EnumerateDirectories effizienter sein.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Diese Methode füllt die Werte der folgenden DirectoryInfo Eigenschaften vorab auf:This method pre-populates the values of the following DirectoryInfo properties:

Die zurückgegebene Auflistung wird nicht zwischengespeichert. jeder aufzurufende GetEnumerator-Methode für die Auflistung startet eine neue-Enumeration.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

EnumerateDirectories(String)

Gibt eine aufzählbare Auflistung von Verzeichnisinformationen zurück, die einem angegebenen Suchmuster entsprechen.Returns an enumerable collection of directory information that matches a specified search pattern.

public:
 System::Collections::Generic::IEnumerable<System::IO::DirectoryInfo ^> ^ EnumerateDirectories(System::String ^ searchPattern);
public System.Collections.Generic.IEnumerable<System.IO.DirectoryInfo> EnumerateDirectories (string searchPattern);
member this.EnumerateDirectories : string -> seq<System.IO.DirectoryInfo>
Public Function EnumerateDirectories (searchPattern As String) As IEnumerable(Of DirectoryInfo)

Parameter

searchPattern
String

Die Suchzeichenfolge für die Überprüfung der Namen von Verzeichnissen auf Übereinstimmungen.The search string to match against the names of directories. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

Gibt zurück

Eine aufzählbare Auflistung von Verzeichnissen, die searchPattern entspricht.An enumerable collection of directories that matches searchPattern.

Ausnahmen

searchPattern ist null.searchPattern is null.

Der im DirectoryInfo-Objekt gekapselte Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Die folgenden Platzhalter spezifiatoren sind in searchPatternzulässig.The following wildcard specifiers are permitted in searchPattern.

Platzhalter BezeichnerWildcard specifier ÜbereinstimmungenMatches
* (Sternchen)* (asterisk) NULL oder mehr Zeichen an dieser Position.Zero or more characters in that position.
?? (Fragezeichen)(question mark) NULL oder ein Zeichen an dieser Position.Zero or one character in that position.

Andere Zeichen als der Platzhalter sind Literalzeichen.Characters other than the wildcard are literal characters. Die Zeichenfolge "*t" sucht z. b. nach allen Namen, die mit dem Buchstaben "t" enden.For example, the string "*t" searches for all names in ending with the letter "t". ".". Die searchPattern Zeichenfolge "s*" sucht nach allen Namen in path beginnend mit dem Buchstaben "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Die Methoden EnumerateDirectories und GetDirectories unterscheiden sich wie folgt:The EnumerateDirectories and GetDirectories methods differ as follows:

  • Wenn Sie EnumerateDirectoriesverwenden, können Sie mit dem Auflisten der Auflistung von DirectoryInfo Objekten beginnen, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Wenn Sie GetDirectoriesverwenden, müssen Sie warten, bis das gesamte Array von DirectoryInfo Objekten zurückgegeben wird, bevor Sie auf das Array zugreifen können.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Wenn Sie also mit vielen Dateien und Verzeichnissen arbeiten, können EnumerateDirectories effizienter sein.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Diese Methode füllt die Werte der folgenden DirectoryInfo Eigenschaften vorab auf:This method pre-populates the values of the following DirectoryInfo properties:

Die zurückgegebene Auflistung wird nicht zwischengespeichert. jeder aufzurufende GetEnumerator-Methode für die Auflistung startet eine neue-Enumeration.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Gilt für: