Directory.EnumerateFileSystemEntries メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した条件を満たすファイル システム エントリの列挙可能なコレクションを返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| EnumerateFileSystemEntries(String) |
指定したパス内のファイル名とディレクトリ名の列挙可能なコレクションを返します。 |
| EnumerateFileSystemEntries(String, String) |
指定したパス内の検索パターンに一致するファイル名とディレクトリ名の列挙可能なコレクションを返します。 |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
指定したパスの検索パターンと列挙オプションに一致する、ファイル名とディレクトリ名の列挙可能なコレクションを返します。 |
| EnumerateFileSystemEntries(String, String, SearchOption) |
指定したパス内の検索パターンに一致するファイル名とディレクトリ名の列挙可能なコレクションを返し、必要に応じてサブディレクトリを検索します。 |
EnumerateFileSystemEntries(String)
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
指定したパス内のファイル名とディレクトリ名の列挙可能なコレクションを返します。
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);static member EnumerateFileSystemEntries : string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)パラメーター
- path
- String
検索するディレクトリへの相対パスまたは絶対パス。 この文字列では大文字と小文字は区別されません。
返品
pathで指定されたディレクトリ内のファイル システム エントリの列挙可能なコレクション。
例外
.NET Framework および .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列で、空白のみを含むか、無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
path は nullです。
path は、マップされていないドライブを参照するなど、無効です。
path はファイル名です。
指定したパス、ファイル名、または組み合わせが、システム定義の最大長を超えています。
呼び出し元に必要なアクセス許可がありません。
呼び出し元に必要なアクセス許可がありません。
注釈
path パラメーターを使用して相対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。これは、 GetCurrentDirectory メソッドを使用して判断できます。
EnumerateFileSystemEntriesメソッドとGetFileSystemEntriesメソッドは次のように異なります。EnumerateFileSystemEntriesを使用すると、コレクション全体が返される前にエントリのコレクションの列挙を開始できます。GetFileSystemEntriesを使用する場合は、配列にアクセスする前に、エントリの配列全体が返されるのを待つ必要があります。 そのため、多くのファイルやディレクトリを操作する場合は、 EnumerateFileSystemEntries の方が効率的です。
返されたコレクションはキャッシュされません。コレクションの GetEnumerator を呼び出すたびに、新しい列挙が開始されます。
適用対象
EnumerateFileSystemEntries(String, String)
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
指定したパス内の検索パターンに一致するファイル名とディレクトリ名の列挙可能なコレクションを返します。
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);static member EnumerateFileSystemEntries : string * string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)パラメーター
- path
- String
検索するディレクトリへの相対パスまたは絶対パス。 この文字列では大文字と小文字は区別されません。
- searchPattern
- String
path内のファイル システム エントリの名前と照合する検索文字列。 このパラメーターには、有効なリテラル パスとワイルドカード (* および ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。
返品
指定した検索パターンに一致する、 path で指定されたディレクトリ内のファイル システム エントリの列挙可能なコレクション。
例外
.NET Framework および .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列で、空白のみを含むか、無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
-又は-
searchPattern には有効なパターンが含まれていません。
path は、マップされていないドライブを参照するなど、無効です。
path はファイル名です。
指定したパス、ファイル名、または組み合わせが、システム定義の最大長を超えています。
呼び出し元に必要なアクセス許可がありません。
呼び出し元に必要なアクセス許可がありません。
注釈
searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。
searchPatternでは、次のワイルドカード指定子を使用できます。
| ワイルドカード指定子 | 一致 |
|---|---|
| * (アスタリスク) | その位置の 0 個以上の文字。 |
| ? (疑問符) | その位置に 1 文字だけ入力します。 |
ワイルドカード以外の文字はリテラル文字です。 たとえば、 searchPattern 文字列 "*t" は、文字 "t" で終わる path 内のすべての名前を検索します。
searchPattern文字列 "s*" は、文字 "s" で始まるpath内のすべての名前を検索します。
Note
"*.txt" などの searchPattern でアスタリスク ワイルドカード文字を使用すると、指定した拡張子の文字数が次のように検索に影響します。
- 指定した拡張子が 3 文字の場合、指定した拡張子で始まる拡張子を持つファイルが返されます。 たとえば、"*.xls" は "book.xls" と "book.xlsx" の両方を返します。
- それ以外のすべての場合、メソッドは指定された拡張子と完全に一致するファイルを返します。 たとえば、"*.ai" は "file.ai" を返しますが、"file.aif" は返しません。
疑問符ワイルドカード文字を使用すると、このメソッドは指定されたファイル拡張子に一致するファイルのみを返します。 たとえば、ディレクトリ内に "file1.txt" と "file1.txtother" という 2 つのファイルがある場合、"file?.txt" は最初のファイルのみを返しますが、検索パターン "file*.txt" は両方のファイルを返します。
searchPattern は、2 つのピリオド ("..") で終わることはできません。または、2 つのピリオド ("..") の後に DirectorySeparatorChar または AltDirectorySeparatorCharを含めることはできません。また、無効な文字を含めることもできます。
GetInvalidPathChars メソッドを使用して、無効な文字のクエリを実行できます。
path パラメーターを使用して相対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。これは、 GetCurrentDirectory メソッドを使用して判断できます。
EnumerateFileSystemEntriesメソッドとGetFileSystemEntriesメソッドは次のように異なります。EnumerateFileSystemEntriesを使用すると、コレクション全体が返される前にエントリのコレクションの列挙を開始できます。GetFileSystemEntriesを使用する場合は、配列にアクセスする前に、エントリの配列全体が返されるのを待つ必要があります。 そのため、多くのファイルやディレクトリを操作する場合は、 EnumerateFileSystemEntries の方が効率的です。
返されたコレクションはキャッシュされません。コレクションの GetEnumerator を呼び出すたびに、新しい列挙が開始されます。
適用対象
EnumerateFileSystemEntries(String, String, EnumerationOptions)
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
指定したパスの検索パターンと列挙オプションに一致する、ファイル名とディレクトリ名の列挙可能なコレクションを返します。
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)パラメーター
- path
- String
検索するディレクトリへの相対パスまたは絶対パス。 この文字列では大文字と小文字は区別されません。
- searchPattern
- String
path内のファイルとディレクトリの名前と照合する検索文字列。 このパラメーターには、有効なリテラル文字とワイルドカード文字の組み合わせを含めることができますが、正規表現はサポートされていません。
- enumerationOptions
- EnumerationOptions
使用する検索と列挙の構成を記述するオブジェクト。
返品
指定した検索パターンと指定した列挙オプションに一致する、 pathで指定されたディレクトリ内のファイル システム エントリの列挙可能なコレクション。
例外
.NET Framework および .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列で、空白のみを含むか、無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
-又は-
searchPattern には有効なパターンが含まれていません。
path は、マップされていないドライブを参照するなど、無効です。
path はファイル名です。
指定したパス、ファイル名、または組み合わせが、システム定義の最大長を超えています。
呼び出し元に必要なアクセス許可がありません。
呼び出し元に必要なアクセス許可がありません。
注釈
searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。
searchPatternでは、次のワイルドカード指定子を使用できます。
| ワイルドカード指定子 | 一致 |
|---|---|
| * (アスタリスク) | その位置の 0 個以上の文字。 |
| ? (疑問符) | その位置に 1 文字だけ入力します。 |
ワイルドカード以外の文字はリテラル文字です。 たとえば、 searchPattern 文字列 "*t" は、文字 "t" で終わる path 内のすべての名前を検索します。
searchPattern文字列 "s*" は、文字 "s" で始まるpath内のすべての名前を検索します。
Note
"*.txt" などの searchPattern でアスタリスク ワイルドカード文字を使用すると、指定した拡張子の文字数が次のように検索に影響します。
- 指定した拡張子が 3 文字の場合、指定した拡張子で始まる拡張子を持つファイルが返されます。 たとえば、"*.xls" は "book.xls" と "book.xlsx" の両方を返します。
- それ以外のすべての場合、メソッドは指定された拡張子と完全に一致するファイルを返します。 たとえば、"*.ai" は "file.ai" を返しますが、"file.aif" は返しません。
疑問符ワイルドカード文字を使用すると、このメソッドは指定されたファイル拡張子に一致するファイルのみを返します。 たとえば、ディレクトリ内に "file1.txt" と "file1.txtother" という 2 つのファイルがある場合、"file?.txt" は最初のファイルのみを返しますが、検索パターン "file*.txt" は両方のファイルを返します。
searchPattern は、2 つのピリオド ("..") で終わることはできません。または、2 つのピリオド ("..") の後に DirectorySeparatorChar または AltDirectorySeparatorCharを含めることはできません。また、無効な文字を含めることもできます。
GetInvalidPathChars メソッドを使用して、無効な文字のクエリを実行できます。
path パラメーターを使用して相対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。これは、 GetCurrentDirectory メソッドを使用して判断できます。
EnumerateFileSystemEntriesメソッドとGetFileSystemEntriesメソッドは次のように異なります。EnumerateFileSystemEntriesを使用すると、コレクション全体が返される前にエントリのコレクションの列挙を開始できます。GetFileSystemEntriesを使用する場合は、配列にアクセスする前に、エントリの配列全体が返されるのを待つ必要があります。 そのため、多くのファイルやディレクトリを操作する場合は、 EnumerateFileSystemEntries の方が効率的です。
返されたコレクションはキャッシュされません。コレクションの GetEnumerator を呼び出すたびに、新しい列挙が開始されます。
適用対象
EnumerateFileSystemEntries(String, String, SearchOption)
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
- ソース:
- Directory.cs
指定したパス内の検索パターンに一致するファイル名とディレクトリ名の列挙可能なコレクションを返し、必要に応じてサブディレクトリを検索します。
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)パラメーター
- path
- String
検索するディレクトリへの相対パスまたは絶対パス。 この文字列では大文字と小文字は区別されません。
- searchPattern
- String
pathのファイル システム エントリと照合する検索文字列。 このパラメーターには、有効なリテラル パスとワイルドカード (* および ?) 文字の組み合わせを含めることができますが、正規表現はサポートされていません。
- searchOption
- SearchOption
検索操作に現在のディレクトリのみを含めるか、すべてのサブディレクトリを含めるかを指定する列挙値の 1 つ。 既定値は TopDirectoryOnly です。
返品
指定した検索パターンとオプションに一致する、 path で指定されたディレクトリ内のファイル システム エントリの列挙可能なコレクション。
例外
.NET Framework および .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列で、空白のみを含むか、無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。
-又は-
searchPattern には有効なパターンが含まれていません。
searchOption が有効な SearchOption 値ではありません。
path は、マップされていないドライブを参照するなど、無効です。
path はファイル名です。
指定したパス、ファイル名、または組み合わせが、システム定義の最大長を超えています。
呼び出し元に必要なアクセス許可がありません。
呼び出し元に必要なアクセス許可がありません。
注釈
searchPattern にはリテラル文字とワイルドカード文字の組み合わせを指定できますが、正規表現はサポートされていません。
searchPatternでは、次のワイルドカード指定子を使用できます。
| ワイルドカード指定子 | 一致 |
|---|---|
| * (アスタリスク) | その位置の 0 個以上の文字。 |
| ? (疑問符) | その位置に 1 文字だけ入力します。 |
ワイルドカード以外の文字はリテラル文字です。 たとえば、 searchPattern 文字列 "*t" は、文字 "t" で終わる path 内のすべての名前を検索します。
searchPattern文字列 "s*" は、文字 "s" で始まるpath内のすべての名前を検索します。
Note
"*.txt" などの searchPattern でアスタリスク ワイルドカード文字を使用すると、指定した拡張子の文字数が次のように検索に影響します。
- 指定した拡張子が 3 文字の場合、指定した拡張子で始まる拡張子を持つファイルが返されます。 たとえば、"*.xls" は "book.xls" と "book.xlsx" の両方を返します。
- それ以外のすべての場合、メソッドは指定された拡張子と完全に一致するファイルを返します。 たとえば、"*.ai" は "file.ai" を返しますが、"file.aif" は返しません。
疑問符ワイルドカード文字を使用すると、このメソッドは指定されたファイル拡張子に一致するファイルのみを返します。 たとえば、ディレクトリ内に "file1.txt" と "file1.txtother" という 2 つのファイルがある場合、"file?.txt" は最初のファイルのみを返しますが、検索パターン "file*.txt" は両方のファイルを返します。
searchPattern は、2 つのピリオド ("..") で終わることはできません。または、2 つのピリオド ("..") の後に DirectorySeparatorChar または AltDirectorySeparatorCharを含めることはできません。また、無効な文字を含めることもできます。
GetInvalidPathChars メソッドを使用して、無効な文字のクエリを実行できます。
path パラメーターを使用して相対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。これは、 GetCurrentDirectory メソッドを使用して判断できます。
EnumerateFileSystemEntriesメソッドとGetFileSystemEntriesメソッドは次のように異なります。EnumerateFileSystemEntriesを使用すると、コレクション全体が返される前にエントリのコレクションの列挙を開始できます。GetFileSystemEntriesを使用する場合は、配列にアクセスする前に、エントリの配列全体が返されるのを待つ必要があります。 そのため、多くのファイルやディレクトリを操作する場合は、 EnumerateFileSystemEntries の方が効率的です。
返されたコレクションはキャッシュされません。コレクションの GetEnumerator を呼び出すたびに、新しい列挙が開始されます。
