DirectoryInfo.EnumerateDirectories メソッド

定義

現在のディレクトリの列挙可能なディレクトリ情報のコレクションを返します。Returns an enumerable collection of directory information in the current directory.

オーバーロード

EnumerateDirectories(String, SearchOption)

指定された検索パターンと、サブディレクトリを検索するかどうかを指定するオプションの設定に一致する列挙可能なディレクトリ情報のコレクションを返します。Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option.

EnumerateDirectories(String, EnumerationOptions)

指定した検索パターンおよび列挙オプションに一致する列挙可能なディレクトリ情報のコレクションを返します。Returns an enumerable collection of directory information that matches the specified search pattern and enumeration options.

EnumerateDirectories()

現在のディレクトリの列挙可能なディレクトリ情報のコレクションを返します。Returns an enumerable collection of directory information in the current directory.

EnumerateDirectories(String)

指定された検索パターンに一致する列挙可能なディレクトリ情報のコレクションを返します。Returns an enumerable collection of directory information that matches a specified search pattern.

EnumerateDirectories(String, SearchOption)

指定された検索パターンと、サブディレクトリを検索するかどうかを指定するオプションの設定に一致する列挙可能なディレクトリ情報のコレクションを返します。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)

パラメーター

searchPattern
String

ディレクトリの名前と照合する検索文字列。The search string to match against the names of directories. このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption

検索操作に現在のディレクトリのみを含めるのか、またはすべてのサブディレクトリを含めるのかを指定する列挙値の 1 つ。One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories. 既定値は TopDirectoryOnly です。The default value is TopDirectoryOnly.

戻り値

IEnumerable<DirectoryInfo>

searchPatternsearchOption に一致する列挙可能なディレクトリのコレクション。An enumerable collection of directories that matches searchPattern and searchOption.

例外

searchPatternnullです。searchPattern is null.

searchOption は正しい SearchOption 値ではありません。searchOption is not a valid SearchOption value.

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

次の例では、このメソッドとメソッドを使用して、 EnumerateFiles start ディレクトリ内のファイルとディレクトリを列挙し、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

注釈

searchPattern には、リテラル文字とワイルドカード文字の組み合わせを使用できますが、正規表現はサポートされていません。searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. では、次のワイルドカード指定子を使用でき searchPattern ます。The following wildcard specifiers are permitted in searchPattern.

ワイルドカード指定子Wildcard specifier [一致する]Matches
* アスタリスク* (asterisk) その位置に0個以上の文字が含まれています。Zero or more characters in that position.
?? (疑問符)(question mark) その位置に0個または1個の文字。Zero or one character in that position.

ワイルドカード以外の文字はリテラル文字です。Characters other than the wildcard are literal characters. たとえば、文字列 " * t" は、末尾に文字 "t" が付いているすべての名前を検索します。For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPattern文字列 "s" は、 * path 文字 "s" で始まるすべての名前を検索します。The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesメソッドとメソッドは次のように GetDirectories 異なります。The EnumerateDirectories and GetDirectories methods differ as follows:

  • を使用すると EnumerateDirectoriesDirectoryInfo コレクション全体が返される前に、オブジェクトのコレクションの列挙を開始できます。When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • を使用するときは GetDirectories 、配列にアクセスする前に、オブジェクトの配列全体が返されるまで待つ必要があり DirectoryInfo ます。When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

そのため、多くのファイルとディレクトリを操作する場合は、の方 EnumerateDirectories が効率的です。Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

このメソッドは、次のプロパティの値を事前に設定し DirectoryInfo ます。This method pre-populates the values of the following DirectoryInfo properties:

返されたコレクションはキャッシュされません。コレクションのメソッドを呼び出すたびに、 GetEnumerator 新しい列挙が開始されます。The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

適用対象

EnumerateDirectories(String, EnumerationOptions)

指定した検索パターンおよび列挙オプションに一致する列挙可能なディレクトリ情報のコレクションを返します。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)

パラメーター

searchPattern
String

ディレクトリの名前と照合する検索文字列。The search string to match against the names of directories. このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

enumerationOptions
EnumerationOptions

使用する検索と列挙の構成を記述するオブジェクト。An object that describes the search and enumeration configuration to use.

戻り値

IEnumerable<DirectoryInfo>

searchPatternenumerationOptions に一致する列挙可能なディレクトリのコレクション。An enumerable collection of directories that matches searchPattern and enumerationOptions.

例外

searchPatternnullです。searchPattern is null.

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

注釈

searchPattern には、リテラル文字とワイルドカード文字の組み合わせを使用できますが、正規表現はサポートされていません。searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. では、次のワイルドカード指定子を使用でき searchPattern ます。The following wildcard specifiers are permitted in searchPattern.

ワイルドカード指定子Wildcard specifier [一致する]Matches
* アスタリスク* (asterisk) その位置に0個以上の文字が含まれています。Zero or more characters in that position.
?? (疑問符)(question mark) その位置に0個または1個の文字。Zero or one character in that position.

ワイルドカード以外の文字はリテラル文字です。Characters other than the wildcard are literal characters. たとえば、文字列 " * t" は、末尾に文字 "t" が付いているすべての名前を検索します。For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPattern文字列 "s" は、 * path 文字 "s" で始まるすべての名前を検索します。The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesメソッドとメソッドは次のように GetDirectories 異なります。The EnumerateDirectories and GetDirectories methods differ as follows:

  • を使用すると EnumerateDirectoriesDirectoryInfo コレクション全体が返される前に、オブジェクトのコレクションの列挙を開始できます。When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • を使用するときは GetDirectories 、配列にアクセスする前に、オブジェクトの配列全体が返されるまで待つ必要があり DirectoryInfo ます。When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

そのため、多くのファイルとディレクトリを操作する場合は、の方 EnumerateDirectories が効率的です。Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

このメソッドは、次のプロパティの値を事前に設定し DirectoryInfo ます。This method pre-populates the values of the following DirectoryInfo properties:

返されたコレクションはキャッシュされません。コレクションのメソッドを呼び出すたびに、 GetEnumerator 新しい列挙が開始されます。The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

適用対象

EnumerateDirectories()

現在のディレクトリの列挙可能なディレクトリ情報のコレクションを返します。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)

戻り値

IEnumerable<DirectoryInfo>

現在のディレクトリ内の列挙可能なディレクトリのコレクション。An enumerable collection of directories in the current directory.

例外

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

次の例では、C:\Program Files ディレクトリの下のサブディレクトリを列挙し、LINQ クエリを使用して、プロパティの値を確認することで、2009より前に作成されたすべてのディレクトリの名前を返し CreationTimeUtc ます。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.

サブディレクトリの名前のみが必要な場合は、静的クラスを使用して Directory パフォーマンスを向上させます。If you only need the names of the subdirectories, use the static Directory class for better performance. 例については、メソッドを参照してください EnumerateDirectories(String)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

注釈

EnumerateDirectoriesメソッドとメソッドは次のように GetDirectories 異なります。The EnumerateDirectories and GetDirectories methods differ as follows:

  • を使用すると EnumerateDirectoriesDirectoryInfo コレクション全体が返される前に、オブジェクトのコレクションの列挙を開始できます。When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • を使用するときは GetDirectories 、配列にアクセスする前に、オブジェクトの配列全体が返されるまで待つ必要があり DirectoryInfo ます。When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

そのため、多くのファイルとディレクトリを操作する場合は、の方 EnumerateDirectories が効率的です。Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

このメソッドは、次のプロパティの値を事前に設定し DirectoryInfo ます。This method pre-populates the values of the following DirectoryInfo properties:

返されたコレクションはキャッシュされません。コレクションのメソッドを呼び出すたびに、 GetEnumerator 新しい列挙が開始されます。The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

適用対象

EnumerateDirectories(String)

指定された検索パターンに一致する列挙可能なディレクトリ情報のコレクションを返します。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)

パラメーター

searchPattern
String

ディレクトリの名前と照合する検索文字列。The search string to match against the names of directories. このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

戻り値

IEnumerable<DirectoryInfo>

searchPattern に一致する列挙可能なディレクトリのコレクション。An enumerable collection of directories that matches searchPattern.

例外

searchPatternnullです。searchPattern is null.

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

注釈

searchPattern には、リテラル文字とワイルドカード文字の組み合わせを使用できますが、正規表現はサポートされていません。searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. では、次のワイルドカード指定子を使用でき searchPattern ます。The following wildcard specifiers are permitted in searchPattern.

ワイルドカード指定子Wildcard specifier [一致する]Matches
* アスタリスク* (asterisk) その位置に0個以上の文字が含まれています。Zero or more characters in that position.
?? (疑問符)(question mark) その位置に0個または1個の文字。Zero or one character in that position.

ワイルドカード以外の文字はリテラル文字です。Characters other than the wildcard are literal characters. たとえば、文字列 " * t" は、末尾に文字 "t" が付いているすべての名前を検索します。For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPattern文字列 "s" は、 * path 文字 "s" で始まるすべての名前を検索します。The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateDirectoriesメソッドとメソッドは次のように GetDirectories 異なります。The EnumerateDirectories and GetDirectories methods differ as follows:

  • を使用すると EnumerateDirectoriesDirectoryInfo コレクション全体が返される前に、オブジェクトのコレクションの列挙を開始できます。When you use EnumerateDirectories, you can start enumerating the collection of DirectoryInfo objects before the whole collection is returned.

  • を使用するときは GetDirectories 、配列にアクセスする前に、オブジェクトの配列全体が返されるまで待つ必要があり DirectoryInfo ます。When you use GetDirectories, you must wait for the whole array of DirectoryInfo objects to be returned before you can access the array.

そのため、多くのファイルとディレクトリを操作する場合は、の方 EnumerateDirectories が効率的です。Therefore, when you are working with many files and directories, EnumerateDirectories can be more efficient.

このメソッドは、次のプロパティの値を事前に設定し DirectoryInfo ます。This method pre-populates the values of the following DirectoryInfo properties:

返されたコレクションはキャッシュされません。コレクションのメソッドを呼び出すたびに、 GetEnumerator 新しい列挙が開始されます。The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

適用対象