DirectoryInfo.EnumerateDirectories Metode

Referensi

Definisi

Ruang nama:: System.IO

Rakitan:: mscorlib.dll, System.IO.FileSystem.dll

Rakitan:: System.IO.FileSystem.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan dalam direktori saat ini.

Overload

EnumerateDirectories(String, SearchOption)	Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian tertentu dan opsi subdirektori pencarian.
EnumerateDirectories(String, EnumerationOptions)	Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dan opsi enumerasi yang ditentukan.
EnumerateDirectories()	Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan dalam direktori saat ini.
EnumerateDirectories(String)	Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian tertentu.

EnumerateDirectories(String, SearchOption)

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian tertentu dan opsi subdirektori pencarian.

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)

Parameter

searchPattern: String

String pencarian yang cocok dengan nama direktori. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

searchOption: SearchOption

Salah satu nilai enumerasi yang menentukan apakah operasi pencarian hanya boleh menyertakan direktori saat ini atau semua subdirektori. Nilai defaultnya adalah TopDirectoryOnly.

Mengembalikan

IEnumerable<DirectoryInfo>

Kumpulan direktori yang dapat dijumlahkan yang cocok searchPattern dengan dan searchOption.

Pengecualian

ArgumentNullException

searchPatternadalah null.

ArgumentOutOfRangeException

searchOption bukan nilai yang valid SearchOption .

DirectoryNotFoundException

Jalur yang dienkapsulasi dalam DirectoryInfo objek tidak valid (misalnya, pada drive yang tidak dipetakan).

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh berikut menggunakan metode ini dan EnumerateFiles metode untuk menghitung file dan direktori dalam direktori mulai dan menampilkan nama dan ukuran file apa pun lebih dari 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}");
        }
    }
}

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

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Nol atau satu karakter dalam posisi tersebut.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, string "*t" mencari semua nama yang berakhiran dengan huruf "t". ". String searchPattern "s*" mencari semua nama yang path dimulai dengan huruf "s".

Metode EnumerateDirectories dan GetDirectories berbeda sebagai berikut:

Saat Anda menggunakan EnumerateDirectories, Anda dapat mulai menghitung koleksi DirectoryInfo objek sebelum seluruh koleksi dikembalikan.
Saat Anda menggunakan GetDirectories, Anda harus menunggu seluruh array DirectoryInfo objek dikembalikan sebelum Anda dapat mengakses array.

Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateDirectories bisa lebih efisien.

Metode ini telah mengisi nilai properti berikut DirectoryInfo :

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator metode pada koleksi akan memulai enumerasi baru.

Berlaku untuk

EnumerateDirectories(String, EnumerationOptions)

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dan opsi enumerasi yang ditentukan.

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)

Parameter

searchPattern: String

String pencarian yang cocok dengan nama direktori. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

enumerationOptions: EnumerationOptions

Objek yang menjelaskan konfigurasi pencarian dan enumerasi untuk digunakan.

Mengembalikan

IEnumerable<DirectoryInfo>

Kumpulan direktori yang dapat dijumlahkan yang cocok searchPattern dengan dan enumerationOptions.

Pengecualian

ArgumentNullException

searchPatternadalah null.

DirectoryNotFoundException

Jalur yang dienkapsulasi dalam DirectoryInfo objek tidak valid (misalnya, pada drive yang tidak dipetakan).

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Nol atau satu karakter dalam posisi tersebut.

Metode EnumerateDirectories dan GetDirectories berbeda sebagai berikut:

Saat Anda menggunakan EnumerateDirectories, Anda dapat mulai menghitung koleksi DirectoryInfo objek sebelum seluruh koleksi dikembalikan.
Saat Anda menggunakan GetDirectories, Anda harus menunggu seluruh array DirectoryInfo objek dikembalikan sebelum Anda dapat mengakses array.

Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateDirectories bisa lebih efisien.

Metode ini telah mengisi nilai properti berikut DirectoryInfo :

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator metode pada koleksi akan memulai enumerasi baru.

Berlaku untuk

EnumerateDirectories()

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan dalam direktori saat ini.

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)

Mengembalikan

IEnumerable<DirectoryInfo>

Kumpulan direktori yang dapat dijumlahkan dalam direktori saat ini.

Pengecualian

DirectoryNotFoundException

Jalur yang dienkapsulasi dalam DirectoryInfo objek tidak valid (misalnya, pada drive yang tidak dipetakan).

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh berikut menghitung subdirektori di bawah direktori C:\Program Files dan menggunakan kueri LINQ untuk mengembalikan nama semua direktori yang dibuat sebelum 2009 dengan memeriksa nilai CreationTimeUtc properti.

Jika Anda hanya memerlukan nama subdirektori, gunakan kelas statis Directory untuk performa yang lebih baik. Misalnya, lihat EnumerateDirectories(String) metode .

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

Keterangan

Metode EnumerateDirectories dan GetDirectories berbeda sebagai berikut:

Saat Anda menggunakan EnumerateDirectories, Anda dapat mulai menghitung koleksi DirectoryInfo objek sebelum seluruh koleksi dikembalikan.
Saat Anda menggunakan GetDirectories, Anda harus menunggu seluruh array DirectoryInfo objek dikembalikan sebelum Anda dapat mengakses array.

Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateDirectories bisa lebih efisien.

Metode ini telah mengisi nilai properti berikut DirectoryInfo :

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator metode pada koleksi akan memulai enumerasi baru.

Berlaku untuk

EnumerateDirectories(String)

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Sumber:: DirectoryInfo.cs

Mengembalikan kumpulan informasi direktori yang dapat dijumlahkan yang cocok dengan pola pencarian tertentu.

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

String pencarian yang cocok dengan nama direktori. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

Mengembalikan

IEnumerable<DirectoryInfo>

Kumpulan direktori yang dapat dijumlahkan yang cocok searchPatterndengan .

Pengecualian

ArgumentNullException

searchPatternadalah null.

DirectoryNotFoundException

Jalur yang dienkapsulasi dalam DirectoryInfo objek tidak valid (misalnya, pada drive yang tidak dipetakan).

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Nol atau satu karakter dalam posisi tersebut.

Metode EnumerateDirectories dan GetDirectories berbeda sebagai berikut:

Saat Anda menggunakan EnumerateDirectories, Anda dapat mulai menghitung koleksi DirectoryInfo objek sebelum seluruh koleksi dikembalikan.
Saat Anda menggunakan GetDirectories, Anda harus menunggu seluruh array DirectoryInfo objek dikembalikan sebelum Anda dapat mengakses array.

Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateDirectories bisa lebih efisien.

Metode ini telah mengisi nilai properti berikut DirectoryInfo :

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator metode pada koleksi akan memulai enumerasi baru.

Berlaku untuk

Bagikan melalui

DirectoryInfo.EnumerateDirectories Metode

Definisi

Overload

EnumerateDirectories(String, SearchOption)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

EnumerateDirectories(String, EnumerationOptions)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

EnumerateDirectories()

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

EnumerateDirectories(String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: