DirectoryInfo.EnumerateDirectories Metoda

Definicja

Zwraca wyliczalną kolekcję informacji katalogowych w bieżącym katalogu.Returns an enumerable collection of directory information in the current directory.

Przeciążenia

EnumerateDirectories(String, SearchOption)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania i opcji przeszukiwania podkatalogu.Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option.

EnumerateDirectories(String, EnumerationOptions)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania i opcji wyliczeniowych.Returns an enumerable collection of directory information that matches the specified search pattern and enumeration options.

EnumerateDirectories()

Zwraca wyliczalną kolekcję informacji katalogowych w bieżącym katalogu.Returns an enumerable collection of directory information in the current directory.

EnumerateDirectories(String)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania.Returns an enumerable collection of directory information that matches a specified search pattern.

EnumerateDirectories(String, SearchOption)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania i opcji przeszukiwania podkatalogu.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>
Public Function EnumerateDirectories (searchPattern As String, searchOption As SearchOption) As IEnumerable(Of DirectoryInfo)

Parametry

searchPattern
String

Ciąg wyszukiwania do dopasowania do nazw katalogów.The search string to match against the names of directories. Ten parametr może zawierać kombinację prawidłowej ścieżki literału i symboli wieloznacznych (* i?), ale nie obsługuje wyrażeń regularnych.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption

Jedna z wartości wyliczenia, która określa, czy operacja wyszukiwania powinna obejmować tylko bieżący katalog lub wszystkie podkatalogi.One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories. Wartość domyślna to TopDirectoryOnly.The default value is TopDirectoryOnly.

Zwraca

IEnumerable<DirectoryInfo>

Wyliczalna kolekcja katalogów, które pasują searchPattern do i searchOption .An enumerable collection of directories that matches searchPattern and searchOption.

Wyjątki

searchPattern to null.searchPattern is null.

searchOption nie jest prawidłową SearchOption wartością.searchOption is not a valid SearchOption value.

Ścieżka Zahermetyzowana w DirectoryInfo obiekcie jest nieprawidłowa (na przykład znajduje się na dysku niezamapowanym).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Obiekt wywołujący nie posiada wymaganych uprawnień.The caller does not have the required permission.

Przykłady

W poniższym przykładzie zastosowano tę metodę i EnumerateFiles metodę wyliczania plików i katalogów w katalogu początkowym oraz wyświetlania nazwy i rozmiaru plików o rozmiarze przekraczającym 10 MB.The following example uses this method and the EnumerateFiles method to enumerate the files and directories within the start directory and display the name and size of any files over 10 MB.

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:N0}");
                    }
                }
                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:N0}");
                            }
                        }
                        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

Uwagi

searchPattern może być kombinacją znaków literału i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Następujące specyfikatory wieloznaczne są dozwolone w searchPattern .The following wildcard specifiers are permitted in searchPattern.

Symbol wieloznacznyWildcard specifier Jest zgodny zMatches
* znaku* (asterisk) Zero lub więcej znaków w tej pozycji.Zero or more characters in that position.
?? (znak zapytania)(question mark) Zero lub jeden znak w tym położeniu.Zero or one character in that position.

Znaki inne niż symbol wieloznaczny są znakami literału.Characters other than the wildcard are literal characters. Na przykład ciąg " * t" wyszukuje wszystkie nazwy kończące się literą "t".For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternCiąg "s * " wyszukuje wszystkie nazwy na path początku literą "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesMetody i GetDirectories różnią się w następujący sposób:The EnumerateDirectories and GetDirectories methods differ as follows:

W związku z tym, gdy pracujesz z wieloma plikami i katalogami, EnumerateDirectories może być bardziej wydajne.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Ta metoda wstępnie wypełnia wartości następujących DirectoryInfo Właściwości:This method pre-populates the values of the following DirectoryInfo properties:

Zwracana kolekcja nie jest buforowana; Każde wywołanie GetEnumerator metody w kolekcji spowoduje rozpoczęcie nowego wyliczenia.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Dotyczy

EnumerateDirectories(String, EnumerationOptions)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania i opcji wyliczeniowych.Returns 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>
Public Function EnumerateDirectories (searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of DirectoryInfo)

Parametry

searchPattern
String

Ciąg wyszukiwania do dopasowania do nazw katalogów.The search string to match against the names of directories. Ten parametr może zawierać kombinację prawidłowej ścieżki literału i symboli wieloznacznych (* i?), ale nie obsługuje wyrażeń regularnych.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

enumerationOptions
EnumerationOptions

Obiekt opisujący konfigurację wyszukiwania i wyliczania do użycia.An object that describes the search and enumeration configuration to use.

Zwraca

IEnumerable<DirectoryInfo>

Wyliczalna kolekcja katalogów, które pasują searchPattern do i enumerationOptions .An enumerable collection of directories that matches searchPattern and enumerationOptions.

Wyjątki

searchPattern to null.searchPattern is null.

Ścieżka Zahermetyzowana w DirectoryInfo obiekcie jest nieprawidłowa (na przykład znajduje się na dysku niezamapowanym).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Obiekt wywołujący nie posiada wymaganych uprawnień.The caller does not have the required permission.

Uwagi

searchPattern może być kombinacją znaków literału i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Następujące specyfikatory wieloznaczne są dozwolone w searchPattern .The following wildcard specifiers are permitted in searchPattern.

Symbol wieloznacznyWildcard specifier Jest zgodny zMatches
* znaku* (asterisk) Zero lub więcej znaków w tej pozycji.Zero or more characters in that position.
?? (znak zapytania)(question mark) Zero lub jeden znak w tym położeniu.Zero or one character in that position.

Znaki inne niż symbol wieloznaczny są znakami literału.Characters other than the wildcard are literal characters. Na przykład ciąg " * t" wyszukuje wszystkie nazwy kończące się literą "t".For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternCiąg "s * " wyszukuje wszystkie nazwy na path początku literą "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesMetody i GetDirectories różnią się w następujący sposób:The EnumerateDirectories and GetDirectories methods differ as follows:

W związku z tym, gdy pracujesz z wieloma plikami i katalogami, EnumerateDirectories może być bardziej wydajne.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Ta metoda wstępnie wypełnia wartości następujących DirectoryInfo Właściwości:This method pre-populates the values of the following DirectoryInfo properties:

Zwracana kolekcja nie jest buforowana; Każde wywołanie GetEnumerator metody w kolekcji spowoduje rozpoczęcie nowego wyliczenia.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Dotyczy

EnumerateDirectories()

Zwraca wyliczalną kolekcję informacji katalogowych w bieżącym katalogu.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)

Zwraca

IEnumerable<DirectoryInfo>

Wyliczalna kolekcja katalogów w bieżącym katalogu.An enumerable collection of directories in the current directory.

Wyjątki

Ścieżka Zahermetyzowana w DirectoryInfo obiekcie jest nieprawidłowa (na przykład znajduje się na dysku niezamapowanym).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Obiekt wywołujący nie posiada wymaganych uprawnień.The caller does not have the required permission.

Przykłady

Poniższy przykład wylicza podkatalogi w katalogu C:\Program Files i używa zapytania LINQ do zwrócenia nazw wszystkich katalogów, które zostały utworzone przed 2009, sprawdzając wartość CreationTimeUtc właściwości.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.

Jeśli potrzebujesz tylko nazw podkatalogów, użyj klasy statycznej Directory w celu zapewnienia lepszej wydajności.If you only need the names of the subdirectories, use the static Directory class for better performance. Aby zapoznać się z przykładem, zobacz EnumerateDirectories(String) metodę.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

Uwagi

EnumerateDirectoriesMetody i GetDirectories różnią się w następujący sposób:The EnumerateDirectories and GetDirectories methods differ as follows:

W związku z tym, gdy pracujesz z wieloma plikami i katalogami, EnumerateDirectories może być bardziej wydajne.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Ta metoda wstępnie wypełnia wartości następujących DirectoryInfo Właściwości:This method pre-populates the values of the following DirectoryInfo properties:

Zwracana kolekcja nie jest buforowana; Każde wywołanie GetEnumerator metody w kolekcji spowoduje rozpoczęcie nowego wyliczenia.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Dotyczy

EnumerateDirectories(String)

Zwraca wyliczalną kolekcję informacji o katalogu, które pasują do określonego wzorca wyszukiwania.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)

Parametry

searchPattern
String

Ciąg wyszukiwania do dopasowania do nazw katalogów.The search string to match against the names of directories. Ten parametr może zawierać kombinację prawidłowej ścieżki literału i symboli wieloznacznych (* i?), ale nie obsługuje wyrażeń regularnych.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

Zwraca

IEnumerable<DirectoryInfo>

Wyliczalna kolekcja katalogów, które pasują do siebie searchPattern .An enumerable collection of directories that matches searchPattern.

Wyjątki

searchPattern to null.searchPattern is null.

Ścieżka Zahermetyzowana w DirectoryInfo obiekcie jest nieprawidłowa (na przykład znajduje się na dysku niezamapowanym).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

Obiekt wywołujący nie posiada wymaganych uprawnień.The caller does not have the required permission.

Uwagi

searchPattern może być kombinacją znaków literału i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Następujące specyfikatory wieloznaczne są dozwolone w searchPattern .The following wildcard specifiers are permitted in searchPattern.

Symbol wieloznacznyWildcard specifier Jest zgodny zMatches
* znaku* (asterisk) Zero lub więcej znaków w tej pozycji.Zero or more characters in that position.
?? (znak zapytania)(question mark) Zero lub jeden znak w tym położeniu.Zero or one character in that position.

Znaki inne niż symbol wieloznaczny są znakami literału.Characters other than the wildcard are literal characters. Na przykład ciąg " * t" wyszukuje wszystkie nazwy kończące się literą "t".For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternCiąg "s * " wyszukuje wszystkie nazwy na path początku literą "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesMetody i GetDirectories różnią się w następujący sposób:The EnumerateDirectories and GetDirectories methods differ as follows:

W związku z tym, gdy pracujesz z wieloma plikami i katalogami, EnumerateDirectories może być bardziej wydajne.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Ta metoda wstępnie wypełnia wartości następujących DirectoryInfo Właściwości:This method pre-populates the values of the following DirectoryInfo properties:

Zwracana kolekcja nie jest buforowana; Każde wywołanie GetEnumerator metody w kolekcji spowoduje rozpoczęcie nowego wyliczenia.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Dotyczy