DirectoryInfo.EnumerateDirectories Méthode

Définition

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.

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.

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.

EnumerateDirectories()

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.

EnumerateDirectories(String)

Retourne une collection énumérable d'informations sur le répertoire qui correspond à un modèle de recherche spécifié.

EnumerateDirectories(String, SearchOption)

Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs

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.

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. 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.

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. La valeur par défaut est TopDirectoryOnly.

Retours

Collection énumérable de répertoires qui correspond à searchPattern et à searchOption.

Exceptions

searchPattern a la valeur null.

searchOption n’est pas une valeur de SearchOption valide.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

L'appelant n'a pas l'autorisation requise.

Exemples

L’exemple suivant utilise cette méthode et la EnumerateFiles méthode pour énumérer les fichiers et répertoires dans le répertoire de démarrage et afficher le nom et la taille des fichiers de plus de 10 Mo.

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}");
        }
    }
}
open System
open System.IO

// Set a variable to the My Documents path.
let docPath = Environment.GetFolderPath Environment.SpecialFolder.MyDocuments

let diTop = DirectoryInfo docPath

try
    for fi in diTop.EnumerateFiles() do
        try
            // Display each file over 10 MB.
            if fi.Length > 10000000 then
                printfn $"{fi.FullName}\t\t{fi.Length:N0}"
        with :? UnauthorizedAccessException as unAuthTop ->
            printfn $"{unAuthTop.Message}"

    for di in diTop.EnumerateDirectories "*" do
        try
            for fi in di.EnumerateFiles("*", SearchOption.AllDirectories) do
                try
                    // Display each file over 10 MB.
                    if fi.Length > 10000000 then
                        printfn $"{fi.FullName}\t\t{fi.Length:N0}"
                with :? UnauthorizedAccessException as unAuthFile ->
                    printfn $"unAuthFile: {unAuthFile.Message}"
        with :? UnauthorizedAccessException as unAuthSubDir ->
            printfn $"unAuthSubDir: {unAuthSubDir.Message}"
with
| :? DirectoryNotFoundException as dirNotFound ->
    Console.WriteLine($"{dirNotFound.Message}")
| :? UnauthorizedAccessException as unAuthDir ->
    printfn $"unAuthDir: {unAuthDir.Message}"
| :? PathTooLongException as longPath ->
    printfn $"{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 génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique Correspond à
* (astérisque) Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation) Zéro ou un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littéraux. Par exemple, la chaîne « *t » recherche tous les noms en se terminant par la lettre « t ». ". La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Les EnumerateDirectories méthodes et diffèrent GetDirectories comme suit :

  • Lorsque vous utilisez EnumerateDirectories, vous pouvez commencer à énumérer la collection d’objets DirectoryInfo avant que la collection entière ne soit retournée.

  • Lorsque vous utilisez GetDirectories, vous devez attendre que l’ensemble du tableau d’objets DirectoryInfo soit retourné avant de pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.

Cette méthode préremplit les valeurs des propriétés suivantes DirectoryInfo :

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.

S’applique à

EnumerateDirectories(String, EnumerationOptions)

Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs

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.

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. 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.

enumerationOptions
EnumerationOptions

Objet qui décrit la configuration de recherche et d’énumération à utiliser.

Retours

Collection énumérable de répertoires qui correspond à searchPattern et à enumerationOptions.

Exceptions

searchPattern a la valeur null.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

L'appelant n'a pas l'autorisation requise.

Remarques

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique Correspond à
* (astérisque) Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation) Zéro ou un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littéraux. Par exemple, la chaîne « *t » recherche tous les noms en se terminant par la lettre « t ». ". La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Les EnumerateDirectories méthodes et diffèrent GetDirectories comme suit :

  • Lorsque vous utilisez EnumerateDirectories, vous pouvez commencer à énumérer la collection d’objets DirectoryInfo avant que la collection entière ne soit retournée.

  • Lorsque vous utilisez GetDirectories, vous devez attendre que l’ensemble du tableau d’objets DirectoryInfo soit retourné avant de pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.

Cette méthode préremplit les valeurs des propriétés suivantes DirectoryInfo :

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.

S’applique à

EnumerateDirectories()

Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs

Retourne une collection énumérable d'informations de répertoires dans le répertoire actif.

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

Collection énumérable des répertoires dans le répertoire actuel.

Exceptions

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

L'appelant n'a pas l'autorisation requise.

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 créés avant 2009 en vérifiant la valeur de la CreationTimeUtc propriété .

Si vous avez uniquement besoin des noms des sous-répertoires, utilisez la classe statique Directory pour de meilleures performances. Pour obtenir un exemple, consultez la EnumerateDirectories(String) méthode .

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>
module program

// <Snippet1>
open System
open System.IO

// Set a variable to the Documents path.
let docPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)

let dirPrograms = DirectoryInfo docPath
let startOf2009 = DateTime(2009, 01, 01)

let dirs =
    query {
        for dir in dirPrograms.EnumerateDirectories() do
        where (dir.CreationTimeUtc > startOf2009)
        select {| ProgDir = dir |}
    }

for di in dirs do
    printfn $"{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 méthodes et diffèrent GetDirectories comme suit :

  • Lorsque vous utilisez EnumerateDirectories, vous pouvez commencer à énumérer la collection d’objets DirectoryInfo avant que la collection entière ne soit retournée.

  • Lorsque vous utilisez GetDirectories, vous devez attendre que l’ensemble du tableau d’objets DirectoryInfo soit retourné avant de pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.

Cette méthode préremplit les valeurs des propriétés suivantes DirectoryInfo :

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.

S’applique à

EnumerateDirectories(String)

Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs
Source:
DirectoryInfo.cs

Retourne une collection énumérable d'informations sur le répertoire qui correspond à un modèle de recherche spécifié.

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. 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.

Retours

Collection énumérable de répertoires qui correspond à searchPattern.

Exceptions

searchPattern a la valeur null.

Le chemin d’accès encapsulé dans l’objet DirectoryInfo n’est pas valide (par exemple, il est sur un lecteur non mappé).

L'appelant n'a pas l'autorisation requise.

Remarques

searchPattern peut être une combinaison de caractères littéraux et génériques, mais elle ne prend pas en charge les expressions régulières. Les spécificateurs génériques suivants sont autorisés dans searchPattern.

Spécificateur générique Correspond à
* (astérisque) Zéro ou plusieurs caractères dans cette position.
? (point d’interrogation) Zéro ou un caractère dans cette position.

Les caractères autres que le caractère générique sont des caractères littéraux. Par exemple, la chaîne « *t » recherche tous les noms en se terminant par la lettre « t ». ". La searchPattern chaîne « s* » recherche tous les noms en path commençant par la lettre « s ».

Les EnumerateDirectories méthodes et diffèrent GetDirectories comme suit :

  • Lorsque vous utilisez EnumerateDirectories, vous pouvez commencer à énumérer la collection d’objets DirectoryInfo avant que la collection entière ne soit retournée.

  • Lorsque vous utilisez GetDirectories, vous devez attendre que l’ensemble du tableau d’objets DirectoryInfo soit retourné avant de pouvoir accéder au tableau.

Par conséquent, lorsque vous travaillez avec de nombreux fichiers et répertoires, EnumerateDirectories peut être plus efficace.

Cette méthode préremplit les valeurs des propriétés suivantes DirectoryInfo :

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.

S’applique à