DirectoryInfo.EnumerateDirectories Méthode

Définition

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.Returns an enumerable collection of directory information in the current directory.

Surcharges

EnumerateDirectories(String, SearchOption)

Retourne une collection énumérable d'informations de répertoire qui correspond à un modèle de recherche spécifié et à une option de recherche de sous-répertoires.Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option.

EnumerateDirectories(String, EnumerationOptions)

Retourne une collection énumérable d'informations de répertoire qui correspond au modèle de recherche et aux options d’énumération que vous spécifiez.Returns an enumerable collection of directory information that matches the specified search pattern and enumeration options.

EnumerateDirectories()

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.Returns an enumerable collection of directory information in the current directory.

EnumerateDirectories(String)

Retourne une collection énumérable d'informations sur le répertoire qui correspond à un modèle de recherche spécifié.Returns an enumerable collection of directory information that matches a specified search pattern.

EnumerateDirectories(String, SearchOption)

Retourne une collection énumérable d'informations de répertoire qui correspond à un modèle de recherche spécifié et à une option de recherche de sous-répertoires.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)

Paramètres

searchPattern
String

Chaîne recherchée à trouver parmi les noms de répertoires.The search string to match against the names of directories. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption

L'une des valeurs d'énumération qui spécifie si l'opération de recherche doit inclure uniquement le répertoire actif ou tous les sous-répertoires.One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories. La valeur par défaut est TopDirectoryOnly.The default value is TopDirectoryOnly.

Retours

IEnumerable<DirectoryInfo>

Collection énumérable de répertoires qui correspond à searchPattern et à searchOption.An enumerable collection of directories that matches searchPattern and searchOption.

Exceptions

searchPattern a la valeur null.searchPattern is null.

searchOption n’est pas une valeur de SearchOption valide.searchOption is not a valid SearchOption value.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Exemples

L’exemple suivant utilise cette méthode et la EnumerateFiles méthode pour énumérer les fichiers et les répertoires dans le répertoire de démarrage et afficher le nom et la taille de tous les fichiers de plus de 10 Mo.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

Remarques

searchPattern peut être une combinaison de caractères littéraux et de caractères génériques, mais elle ne prend pas en charge les expressions régulières.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Les spécificateurs de caractères génériques suivants sont autorisés dans searchPattern .The following wildcard specifiers are permitted in searchPattern.

Spécificateur de caractère génériqueWildcard specifier Correspond àMatches
* sert* (asterisk) Zéro, un ou plusieurs caractères dans cette position.Zero or more characters in that position.
?? (point d’interrogation)(question mark) Zéro ou un caractère dans cette position.Zero or one character in that position.

Les caractères autres que le caractère générique sont des caractères littéraux.Characters other than the wildcard are literal characters. Par exemple, la chaîne « * t » recherche tous les noms se terminant par la lettre « t ».For example, the string "*t" searches for all names in ending with the letter "t". ".". La searchPattern chaîne « s * » recherche tous les noms dans, en path commençant par la lettre « s ».The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Les EnumerateDirectories GetDirectories méthodes et diffèrent comme suit :The EnumerateDirectories and GetDirectories methods differ as follows:

  • Lorsque vous utilisez EnumerateDirectories , vous pouvez commencer à énumérer la collection d' DirectoryInfo objets avant que la collection entière soit retournée.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Lorsque vous utilisez GetDirectories , vous devez attendre que l’ensemble du tableau d' DirectoryInfo objets soit retourné pour pouvoir accéder au tableau.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Cette méthode pré-remplit les valeurs des DirectoryInfo propriétés suivantes :This method pre-populates the values of the following DirectoryInfo properties:

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

S’applique à

EnumerateDirectories(String, EnumerationOptions)

Retourne une collection énumérable d'informations de répertoire qui correspond au modèle de recherche et aux options d’énumération que vous spécifiez.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)

Paramètres

searchPattern
String

Chaîne recherchée à trouver parmi les noms de répertoires.The search string to match against the names of directories. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

enumerationOptions
EnumerationOptions

Objet qui décrit la configuration de recherche et d’énumération à utiliser.An object that describes the search and enumeration configuration to use.

Retours

IEnumerable<DirectoryInfo>

Collection énumérable de répertoires qui correspond à searchPattern et à enumerationOptions.An enumerable collection of directories that matches searchPattern and enumerationOptions.

Exceptions

searchPattern a la valeur null.searchPattern is null.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Remarques

searchPattern peut être une combinaison de caractères littéraux et de caractères génériques, mais elle ne prend pas en charge les expressions régulières.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Les spécificateurs de caractères génériques suivants sont autorisés dans searchPattern .The following wildcard specifiers are permitted in searchPattern.

Spécificateur de caractère génériqueWildcard specifier Correspond àMatches
* sert* (asterisk) Zéro, un ou plusieurs caractères dans cette position.Zero or more characters in that position.
?? (point d’interrogation)(question mark) Zéro ou un caractère dans cette position.Zero or one character in that position.

Les caractères autres que le caractère générique sont des caractères littéraux.Characters other than the wildcard are literal characters. Par exemple, la chaîne « * t » recherche tous les noms se terminant par la lettre « t ».For example, the string "*t" searches for all names in ending with the letter "t". ".". La searchPattern chaîne « s * » recherche tous les noms dans, en path commençant par la lettre « s ».The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Les EnumerateDirectories GetDirectories méthodes et diffèrent comme suit :The EnumerateDirectories and GetDirectories methods differ as follows:

  • Lorsque vous utilisez EnumerateDirectories , vous pouvez commencer à énumérer la collection d' DirectoryInfo objets avant que la collection entière soit retournée.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Lorsque vous utilisez GetDirectories , vous devez attendre que l’ensemble du tableau d' DirectoryInfo objets soit retourné pour pouvoir accéder au tableau.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Cette méthode pré-remplit les valeurs des DirectoryInfo propriétés suivantes :This method pre-populates the values of the following DirectoryInfo properties:

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

S’applique à

EnumerateDirectories()

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.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)

Retours

IEnumerable<DirectoryInfo>

Collection énumérable des répertoires dans le répertoire actuel.An enumerable collection of directories in the current directory.

Exceptions

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Exemples

L’exemple suivant énumère les sous-répertoires sous le répertoire C:\Program Files et utilise une requête LINQ pour retourner les noms de tous les répertoires qui ont été créés avant 2009 en vérifiant la valeur de la CreationTimeUtc propriété.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.

Si vous avez uniquement besoin des noms des sous-répertoires, utilisez la Directory classe statique pour de meilleures performances.If you only need the names of the subdirectories, use the static Directory class for better performance. Pour obtenir un exemple, consultez la EnumerateDirectories(String) méthode.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

Remarques

Les EnumerateDirectories GetDirectories méthodes et diffèrent comme suit :The EnumerateDirectories and GetDirectories methods differ as follows:

  • Lorsque vous utilisez EnumerateDirectories , vous pouvez commencer à énumérer la collection d' DirectoryInfo objets avant que la collection entière soit retournée.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Lorsque vous utilisez GetDirectories , vous devez attendre que l’ensemble du tableau d' DirectoryInfo objets soit retourné pour pouvoir accéder au tableau.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Cette méthode pré-remplit les valeurs des DirectoryInfo propriétés suivantes :This method pre-populates the values of the following DirectoryInfo properties:

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

S’applique à

EnumerateDirectories(String)

Retourne une collection énumérable d'informations sur le répertoire qui correspond à un modèle de recherche spécifié.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)

Paramètres

searchPattern
String

Chaîne recherchée à trouver parmi les noms de répertoires.The search string to match against the names of directories. Ce paramètre peut contenir une combinaison d’un chemin littéral valide et de caractères génériques (* et ?), mais il ne prend pas en charge les expressions régulières.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

Retours

IEnumerable<DirectoryInfo>

Collection énumérable de répertoires qui correspond à searchPattern.An enumerable collection of directories that matches searchPattern.

Exceptions

searchPattern a la valeur null.searchPattern is null.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Remarques

searchPattern peut être une combinaison de caractères littéraux et de caractères génériques, mais elle ne prend pas en charge les expressions régulières.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Les spécificateurs de caractères génériques suivants sont autorisés dans searchPattern .The following wildcard specifiers are permitted in searchPattern.

Spécificateur de caractère génériqueWildcard specifier Correspond àMatches
* sert* (asterisk) Zéro, un ou plusieurs caractères dans cette position.Zero or more characters in that position.
?? (point d’interrogation)(question mark) Zéro ou un caractère dans cette position.Zero or one character in that position.

Les caractères autres que le caractère générique sont des caractères littéraux.Characters other than the wildcard are literal characters. Par exemple, la chaîne « * t » recherche tous les noms se terminant par la lettre « t ».For example, the string "*t" searches for all names in ending with the letter "t". ".". La searchPattern chaîne « s * » recherche tous les noms dans, en path commençant par la lettre « s ».The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Les EnumerateDirectories GetDirectories méthodes et diffèrent comme suit :The EnumerateDirectories and GetDirectories methods differ as follows:

  • Lorsque vous utilisez EnumerateDirectories , vous pouvez commencer à énumérer la collection d' DirectoryInfo objets avant que la collection entière soit retournée.When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • Lorsque vous utilisez GetDirectories , vous devez attendre que l’ensemble du tableau d' DirectoryInfo objets soit retourné pour pouvoir accéder au tableau.When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

Cette méthode pré-remplit les valeurs des DirectoryInfo propriétés suivantes :This method pre-populates the values of the following DirectoryInfo properties:

La collection retournée n’est pas mise en cache ; chaque appel à la GetEnumerator méthode sur la collection démarre une nouvelle énumération.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

S’applique à