DirectoryInfo.EnumerateFileSystemInfos メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

現在のディレクトリ内の列挙可能なファイル システム情報のコレクションを返します。

オーバーロード

EnumerateFileSystemInfos(String, SearchOption)	指定された検索パターンと、サブディレクトリを検索するかどうかを指定するオプションの設定に一致する列挙可能なファイル システム情報のコレクションを返します。
EnumerateFileSystemInfos()	現在のディレクトリ内の列挙可能なファイル システム情報のコレクションを返します。
EnumerateFileSystemInfos(String)	指定された検索パターンに一致する列挙可能なファイル システム情報のコレクションを返します。
EnumerateFileSystemInfos(String, EnumerationOptions)	指定した検索パターンと列挙オプションに一致する列挙可能なファイル システム情報のコレクションを返します。

EnumerateFileSystemInfos(String, SearchOption)

ソース:

DirectoryInfo.cs

指定された検索パターンと、サブディレクトリを検索するかどうかを指定するオプションの設定に一致する列挙可能なファイル システム情報のコレクションを返します。

public:
 System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern, System::IO::SearchOption searchOption);

public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern, System.IO.SearchOption searchOption);

member this.EnumerateFileSystemInfos : string * System.IO.SearchOption -> seq<System.IO.FileSystemInfo>

Public Function EnumerateFileSystemInfos (searchPattern As String, searchOption As SearchOption) As IEnumerable(Of FileSystemInfo)

パラメーター

searchPattern

String

ディレクトリの名前と照合する検索文字列。 このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。

searchOption

SearchOption

検索操作に現在のディレクトリのみを含めるのか、またはすべてのサブディレクトリを含めるのかを指定する列挙値の 1 つ。 既定値は TopDirectoryOnly です。

戻り値

IEnumerable<FileSystemInfo>

searchPattern および searchOption に一致する列挙可能なファイル システム情報オブジェクトのコレクション。

例外

ArgumentNullException

searchPattern が nullです。

ArgumentOutOfRangeException

searchOption は正しい SearchOption 値ではありません。

DirectoryNotFoundException

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

注釈

searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。 では、次のワイルドカード指定子を searchPattern使用できます。

ワイルドカード指定子	［一致する］
* (アスタリスク)	その位置の 0 個以上の文字。
? (疑問符)	その位置の 0 文字または 1 文字。

ワイルドカード以外の文字はリテラル文字です。 たとえば、文字列 "*t" は文字 "t" で終わるすべての名前を検索します。 ". searchPattern文字列 "s*" は、文字 "s" でpath始まるすべての名前を検索します。

メソッドと GetFileSystemInfos メソッドはEnumerateFileSystemInfos次のように異なります。

• を使用 EnumerateFileSystemInfosすると、コレクション全体が返される前に、オブジェクトのコレクションの FileSystemInfo 列挙を開始できます。

• を使用 GetFileSystemInfosする場合は、オブジェクトの配列全体が返されるの FileSystemInfo を待ってから、配列にアクセスする必要があります。

そのため、多くのファイルとディレクトリを操作する場合は、 EnumerateFileSystemInfos の方が効率的です。

このメソッドは、次 FileSystemInfo のプロパティの値を事前に設定します。

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

返されたコレクションはキャッシュされません。コレクションの メソッドを GetEnumerator 呼び出すたびに、新しい列挙が開始されます。

こちらもご覧ください

• FileSystemWatcher

EnumerateFileSystemInfos()

ソース:

DirectoryInfo.cs

現在のディレクトリ内の列挙可能なファイル システム情報のコレクションを返します。

public:
 System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos();

public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos ();

member this.EnumerateFileSystemInfos : unit -> seq<System.IO.FileSystemInfo>

Public Function EnumerateFileSystemInfos () As IEnumerable(Of FileSystemInfo)

戻り値

IEnumerable<FileSystemInfo>

現在のディレクトリ内の列挙可能なファイル システム情報のコレクション。

例外

DirectoryNotFoundException

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

注釈

メソッドと GetFileSystemInfos メソッドはEnumerateFileSystemInfos次のように異なります。

• を使用 EnumerateFileSystemInfosすると、コレクション全体が返される前に、オブジェクトのコレクションの FileSystemInfo 列挙を開始できます。

• を使用 GetFileSystemInfosする場合は、オブジェクトの配列全体が返されるの FileSystemInfo を待ってから、配列にアクセスする必要があります。

そのため、多くのファイルとディレクトリを操作する場合は、 EnumerateFileSystemInfos の方が効率的です。

このメソッドは、次 FileSystemInfo のプロパティの値を事前に設定します。

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

返されたコレクションはキャッシュされません。コレクションの メソッドを GetEnumerator 呼び出すたびに、新しい列挙が開始されます。

こちらもご覧ください

• FileSystemWatcher

EnumerateFileSystemInfos(String)

ソース:

DirectoryInfo.cs

指定された検索パターンに一致する列挙可能なファイル システム情報のコレクションを返します。

public:
 System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern);

public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern);

member this.EnumerateFileSystemInfos : string -> seq<System.IO.FileSystemInfo>

Public Function EnumerateFileSystemInfos (searchPattern As String) As IEnumerable(Of FileSystemInfo)

パラメーター

searchPattern

String

ディレクトリの名前と照合する検索文字列。 このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。

戻り値

IEnumerable<FileSystemInfo>

searchPattern に一致する列挙可能なファイル システム情報オブジェクトのコレクション。

例外

ArgumentNullException

searchPattern が nullです。

DirectoryNotFoundException

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

注釈

searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。 では、次のワイルドカード指定子を searchPattern使用できます。

ワイルドカード指定子	［一致する］
* (アスタリスク)	その位置の 0 個以上の文字。
? (疑問符)	その位置の 0 文字または 1 文字。

ワイルドカード以外の文字はリテラル文字です。 たとえば、文字列 "*t" は文字 "t" で終わるすべての名前を検索します。 ". searchPattern文字列 "s*" は、文字 "s" でpath始まるすべての名前を検索します。

メソッドと GetFileSystemInfos メソッドはEnumerateFileSystemInfos次のように異なります。

• を使用 EnumerateFileSystemInfosすると、コレクション全体が返される前に、オブジェクトのコレクションの FileSystemInfo 列挙を開始できます。

• を使用 GetFileSystemInfosする場合は、オブジェクトの配列全体が返されるの FileSystemInfo を待ってから、配列にアクセスする必要があります。

そのため、多くのファイルとディレクトリを操作する場合は、 EnumerateFileSystemInfos の方が効率的です。

このメソッドは、次 FileSystemInfo のプロパティの値を事前に設定します。

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

返されたコレクションはキャッシュされません。コレクションの メソッドを GetEnumerator 呼び出すたびに、新しい列挙が開始されます。

こちらもご覧ください

• FileSystemWatcher

EnumerateFileSystemInfos(String, EnumerationOptions)

ソース:

DirectoryInfo.cs

指定した検索パターンと列挙オプションに一致する列挙可能なファイル システム情報のコレクションを返します。

public:
 System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern, System.IO.EnumerationOptions enumerationOptions);

member this.EnumerateFileSystemInfos : string * System.IO.EnumerationOptions -> seq<System.IO.FileSystemInfo>

Public Function EnumerateFileSystemInfos (searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of FileSystemInfo)

パラメーター

searchPattern

String

ディレクトリの名前と照合する検索文字列。 このパラメーターには有効なリテラルのパスとワイルドカード (* と ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。

enumerationOptions

EnumerationOptions

使用する検索と列挙の構成を記述するオブジェクト。

戻り値

IEnumerable<FileSystemInfo>

searchPattern および enumerationOptions に一致する列挙可能なファイル システム情報オブジェクトのコレクション。

例外

ArgumentNullException

searchPattern が nullです。

DirectoryNotFoundException

DirectoryInfo オブジェクト内のカプセル化されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。

SecurityException

呼び出し元に、必要なアクセス許可がありません。

注釈

searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。 では、次のワイルドカード指定子を searchPattern使用できます。

ワイルドカード指定子	［一致する］
* (アスタリスク)	その位置の 0 個以上の文字。
? (疑問符)	その位置の 0 文字または 1 文字。

ワイルドカード以外の文字はリテラル文字です。 たとえば、文字列 "*t" は文字 "t" で終わるすべての名前を検索します。 ". searchPattern文字列 "s*" は、文字 "s" でpath始まるすべての名前を検索します。

メソッドと GetFileSystemInfos メソッドはEnumerateFileSystemInfos次のように異なります。

• を使用 EnumerateFileSystemInfosすると、コレクション全体が返される前に、オブジェクトのコレクションの FileSystemInfo 列挙を開始できます。

• を使用 GetFileSystemInfosする場合は、オブジェクトの配列全体が返されるの FileSystemInfo を待ってから、配列にアクセスする必要があります。

そのため、多くのファイルとディレクトリを操作する場合は、 EnumerateFileSystemInfos の方が効率的です。

このメソッドは、次 FileSystemInfo のプロパティの値を事前に設定します。

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

返されたコレクションはキャッシュされません。コレクションの メソッドを GetEnumerator 呼び出すたびに、新しい列挙が開始されます。