DirectoryInfo.EnumerateDirectories Yöntem

Başvuru

Tanım

Ad Alanı:: System.IO

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.IO.FileSystem.dll

Bütünleştirilmiş Kod:: System.IO.FileSystem.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli dizindeki dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.

Aşırı Yüklemeler

EnumerateDirectories(String, SearchOption)	Belirtilen arama deseni ve arama alt dizini seçeneğiyle eşleşen numaralandırılabilir bir dizin bilgileri koleksiyonu döndürür.
EnumerateDirectories(String, EnumerationOptions)	Belirtilen arama deseni ve numaralandırma seçenekleriyle eşleşen dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.
EnumerateDirectories()	Geçerli dizindeki dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.
EnumerateDirectories(String)	Belirtilen arama deseni ile eşleşen dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.

EnumerateDirectories(String, SearchOption)

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Belirtilen arama deseni ve arama alt dizini seçeneğiyle eşleşen numaralandırılabilir bir dizin bilgileri koleksiyonu döndürür.

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)

Parametreler

searchPattern: String

Dizin adları ile eşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ile joker karakter (* ve ?) karakterlerin bir bileşimini içerebilir, ancak normal ifadeleri desteklemez.

searchOption: SearchOption

Arama işleminin yalnızca geçerli dizini mi yoksa tüm alt dizinleri mi içermesi gerektiğini belirten numaralandırma değerlerinden biri. TopDirectoryOnly varsayılan değerdir.

Döndürülenler

IEnumerable<DirectoryInfo>

ve searchOptionile eşleşen searchPattern dizinlerin numaralandırılabilir koleksiyonu.

Özel durumlar

ArgumentNullException

searchPattern, null değeridir.

ArgumentOutOfRangeException

searchOption geçerli SearchOption bir değer değil.

DirectoryNotFoundException

Nesnede DirectoryInfo kapsüllenen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

SecurityException

Çağıranın gerekli izni yok.

Örnekler

Aşağıdaki örnek bu yöntemi ve EnumerateFiles yöntemini kullanarak başlangıç dizinindeki dosyaları ve dizinleri numaralandırır ve 10 MB üzerindeki dosyaların adını ve boyutunu görüntüler.

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

Açıklamalar

searchPattern değişmez karakter ve joker karakterlerin birleşimi olabilir, ancak normal ifadeleri desteklemez. içinde aşağıdaki joker karakter tanımlayıcılara izin verilir searchPattern.

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda sıfır veya bir karakter.

Joker karakter dışındaki karakterler değişmez karakterlerdir. Örneğin, "*t" dizesi "t" harfiyle biten tüm adları arar. ". searchPattern"s*" dizesi, "s" harfiyle başlayan tüm adları path arar.

EnumerateDirectories ve GetDirectories yöntemleri aşağıdaki gibi farklılık gösterir:

kullandığınızda EnumerateDirectories, tüm koleksiyon döndürülmeden önce nesne koleksiyonunu DirectoryInfo numaralandırmaya başlayabilirsiniz.
kullandığınızda GetDirectories, diziye erişebilmeniz için önce nesne dizisinin tamamının DirectoryInfo döndürülmesini beklemeniz gerekir.

Bu nedenle, birçok dosya ve dizinle EnumerateDirectories çalışırken daha verimli olabilir.

Bu yöntem, aşağıdaki DirectoryInfo özelliklerin değerlerini önceden doldurur:

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki GetEnumerator yöntemine yapılan her çağrı yeni bir numaralandırma başlatır.

Şunlara uygulanır

EnumerateDirectories(String, EnumerationOptions)

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Belirtilen arama deseni ve numaralandırma seçenekleriyle eşleşen dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.

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)

Parametreler

searchPattern: String

Dizin adları ile eşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ile joker karakter (* ve ?) karakterlerin bir bileşimini içerebilir, ancak normal ifadeleri desteklemez.

enumerationOptions: EnumerationOptions

Kullanılacak arama ve numaralandırma yapılandırmasını açıklayan bir nesne.

Döndürülenler

IEnumerable<DirectoryInfo>

ve enumerationOptionsile eşleşen searchPattern dizinlerin numaralandırılabilir koleksiyonu.

Özel durumlar

ArgumentNullException

searchPattern, null değeridir.

DirectoryNotFoundException

Nesnede DirectoryInfo kapsüllenen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

SecurityException

Çağıranın gerekli izni yok.

Açıklamalar

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda sıfır veya bir karakter.

EnumerateDirectories ve GetDirectories yöntemleri aşağıdaki gibi farklılık gösterir:

kullandığınızda EnumerateDirectories, tüm koleksiyon döndürülmeden önce nesne koleksiyonunu DirectoryInfo numaralandırmaya başlayabilirsiniz.
kullandığınızda GetDirectories, diziye erişebilmeniz için önce nesne dizisinin tamamının DirectoryInfo döndürülmesini beklemeniz gerekir.

Bu nedenle, birçok dosya ve dizinle EnumerateDirectories çalışırken daha verimli olabilir.

Bu yöntem, aşağıdaki DirectoryInfo özelliklerin değerlerini önceden doldurur:

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki GetEnumerator yöntemine yapılan her çağrı yeni bir numaralandırma başlatır.

Şunlara uygulanır

EnumerateDirectories()

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Geçerli dizindeki dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.

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)

Döndürülenler

IEnumerable<DirectoryInfo>

Geçerli dizindeki numaralandırılabilir dizin koleksiyonu.

Özel durumlar

DirectoryNotFoundException

Nesnede DirectoryInfo kapsüllenen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

SecurityException

Çağıranın gerekli izni yok.

Örnekler

Aşağıdaki örnek, C:\Program Files dizini altındaki alt dizinleri numaralandırır ve özelliğin değerini CreationTimeUtc denetleyerek 2009'da oluşturulan tüm dizinlerin adlarını döndürmek için bir LINQ sorgusu kullanır.

Yalnızca alt dizinlerin adlarına ihtiyacınız varsa, daha iyi performans için statik Directory sınıfı kullanın. Bir örnek için yöntemine EnumerateDirectories(String) bakın.

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

Açıklamalar

EnumerateDirectories ve GetDirectories yöntemleri aşağıdaki gibi farklılık gösterir:

kullandığınızda EnumerateDirectories, tüm koleksiyon döndürülmeden önce nesne koleksiyonunu DirectoryInfo numaralandırmaya başlayabilirsiniz.
kullandığınızda GetDirectories, diziye erişebilmeniz için önce nesne dizisinin tamamının DirectoryInfo döndürülmesini beklemeniz gerekir.

Bu nedenle, birçok dosya ve dizinle EnumerateDirectories çalışırken daha verimli olabilir.

Bu yöntem, aşağıdaki DirectoryInfo özelliklerin değerlerini önceden doldurur:

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki GetEnumerator yöntemine yapılan her çağrı yeni bir numaralandırma başlatır.

Şunlara uygulanır

EnumerateDirectories(String)

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Kaynak:: DirectoryInfo.cs

Belirtilen arama deseni ile eşleşen dizin bilgilerinin numaralandırılabilir bir koleksiyonunu döndürür.

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)

Parametreler

searchPattern: String

Dizin adları ile eşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ile joker karakter (* ve ?) karakterlerin bir bileşimini içerebilir, ancak normal ifadeleri desteklemez.

Döndürülenler

IEnumerable<DirectoryInfo>

ile eşleşen searchPatternnumaralandırılabilir dizin koleksiyonu.

Özel durumlar

ArgumentNullException

searchPattern, null değeridir.

DirectoryNotFoundException

Nesnede DirectoryInfo kapsüllenen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

SecurityException

Çağıranın gerekli izni yok.

Açıklamalar

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda sıfır veya bir karakter.

EnumerateDirectories ve GetDirectories yöntemleri aşağıdaki gibi farklılık gösterir:

kullandığınızda EnumerateDirectories, tüm koleksiyon döndürülmeden önce nesne koleksiyonunu DirectoryInfo numaralandırmaya başlayabilirsiniz.
kullandığınızda GetDirectories, diziye erişebilmeniz için önce nesne dizisinin tamamının DirectoryInfo döndürülmesini beklemeniz gerekir.

Bu nedenle, birçok dosya ve dizinle EnumerateDirectories çalışırken daha verimli olabilir.

Bu yöntem, aşağıdaki DirectoryInfo özelliklerin değerlerini önceden doldurur:

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki GetEnumerator yöntemine yapılan her çağrı yeni bir numaralandırma başlatır.

Şunlara uygulanır

Aracılığıyla paylaş

DirectoryInfo.EnumerateDirectories Yöntem

Tanım

Aşırı Yüklemeler

EnumerateDirectories(String, SearchOption)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

EnumerateDirectories(String, EnumerationOptions)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

EnumerateDirectories()

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

EnumerateDirectories(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar