語言

Directory.EnumerateFileSystemEntries 方法

定義

命名空間:
System.IO
組件:
mscorlib.dll, System.IO.FileSystem.dll
組件:
netstandard.dll, System.Runtime.dll
組件:
netstandard.dll, System.IO.FileSystem.dll
組件:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
組件:
System.IO.FileSystem.dll
組件:
mscorlib.dll
組件:
netstandard.dll

回傳一組符合指定條件的可枚舉檔案系統條目集合。

多載

名稱 Description
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

指向目錄的相對或絕對路徑。 此字串不區分大小寫。

傳回

IEnumerable<String>

目錄中由 指定 path的可枚舉檔案系統條目集合。

例外狀況

ArgumentException

.NET Framework 及 2.1 .NET Core 版本：path 為零長度字串，僅含空白，或包含無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。

ArgumentNullException

path 是 null。

DirectoryNotFoundException

path 不成立，例如指未映射的硬碟。

IOException

path 是一個檔案名稱。

PathTooLongException

指定的路徑、檔案名稱或組合長度超過系統定義的最大長度。

SecurityException

來電者沒有所需的權限。

UnauthorizedAccessException

來電者沒有所需的權限。

備註

你可以用參數 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 此參數可包含有效的文字路徑與通配符（* 與 ？）字元，但不支援正則表達式。

傳回

IEnumerable<String>

一個可枚舉的檔案系統條目集合，位於由 和 path 指定的目錄中，符合指定搜尋模式。

例外狀況

ArgumentException

.NET Framework 及 2.1 .NET Core 版本：path 為零長度字串，僅含空白，或包含無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。

-或-

searchPattern 不包含有效的模式。

ArgumentNullException

path 是 null。

-或-

searchPattern 是 null。

DirectoryNotFoundException

path 不成立，例如指未映射的硬碟。

IOException

path 是一個檔案名稱。

PathTooLongException

指定的路徑、檔案名稱或組合長度超過系統定義的最大長度。

SecurityException

來電者沒有所需的權限。

UnauthorizedAccessException

來電者沒有所需的權限。

備註

searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern

萬用字元指定器 比對
* （星號） 沒有或多個角色處於那個位置。
? (問號) 只有一個角色處於那個位置。

除了萬用卡以外的角色，都是字面上的字面角色。 例如， searchPattern 字串「*t」搜尋所有以 path 字母「t」結尾的名字。 searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。

Note

當你在像「*.txt」這樣的字元中使用星號萬用字 searchPattern 元時，指定副檔名中的字元數會影響搜尋結果，如下：

  • 若指定的副檔名正好為三個字元長，該方法會回傳以指定副檔名開頭的檔案。 例如，「*.xls」會回傳「book.xls」和「book.xlsx」。
  • 在其他所有情況下，該方法回傳的檔案都完全符合指定的副檔名。 例如，「*.ai」回傳「file.ai」，但不會回傳「file.aif」。

當你使用問號萬用字元時，這個方法只會回傳與指定副檔名相符的檔案。 例如，給定兩個檔案「file1.txt」和「file1.txtother」，在一個目錄中，搜尋模式為「file？」.txt“只會回傳第一個檔案，而搜尋「file*.txt」則會回傳兩個檔案。

searchPattern 不能以兩個句號（“..”）結尾，也不能包含兩個句號（“..”）後接 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

一個描述搜尋與列舉配置的物件。

傳回

IEnumerable<String>

由 指定 path於 的目錄中可枚舉的檔案系統條目集合，符合指定的搜尋模式與列舉選項。

例外狀況

ArgumentException

.NET Framework 及 2.1 .NET Core 版本：path 為零長度字串，僅含空白，或包含無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。

-或-

searchPattern 不包含有效的模式。

ArgumentNullException

path 是 null。

-或-

searchPattern 是 null。

DirectoryNotFoundException

path 不成立，例如指未映射的硬碟。

IOException

path 是一個檔案名稱。

PathTooLongException

指定的路徑、檔案名稱或組合長度超過系統定義的最大長度。

SecurityException

來電者沒有所需的權限。

UnauthorizedAccessException

來電者沒有所需的權限。

備註

searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern

萬用字元指定器 比對
* （星號） 沒有或多個角色處於那個位置。
? (問號) 只有一個角色處於那個位置。

除了萬用卡以外的角色，都是字面上的字面角色。 例如， searchPattern 字串「*t」搜尋所有以 path 字母「t」結尾的名字。 searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。

Note

當你在像「*.txt」這樣的字元中使用星號萬用字 searchPattern 元時，指定副檔名中的字元數會影響搜尋結果，如下：

  • 若指定的副檔名正好為三個字元長，該方法會回傳以指定副檔名開頭的檔案。 例如，「*.xls」會回傳「book.xls」和「book.xlsx」。
  • 在其他所有情況下，該方法回傳的檔案都完全符合指定的副檔名。 例如，「*.ai」回傳「file.ai」，但不會回傳「file.aif」。

當你使用問號萬用字元時，這個方法只會回傳與指定副檔名相符的檔案。 例如，給定兩個檔案「file1.txt」和「file1.txtother」，在一個目錄中，搜尋模式為「file？」.txt“只會回傳第一個檔案，而搜尋「file*.txt」則會回傳兩個檔案。

searchPattern 不能以兩個句號（“..”）結尾，也不能包含兩個句號（“..”）後接 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

列舉值之一，指定搜尋操作應只包含目前目錄，或應包含所有子目錄。 預設值為 TopDirectoryOnly。

傳回

IEnumerable<String>

一個可枚舉的檔案系統條目集合，這些條目在由 和 path 指定的目錄中，符合指定的搜尋模式與選項。

例外狀況

ArgumentException

.NET Framework 及 2.1 .NET Core 版本：path 為零長度字串，僅含空白，或包含無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。

-或-

searchPattern 不包含有效的模式。

ArgumentNullException

path 是 null。

-或-

searchPattern 是 null。

ArgumentOutOfRangeException

searchOption 不是一個有效的 SearchOption 值。

DirectoryNotFoundException

path 不成立，例如指未映射的硬碟。

IOException

path 是一個檔案名稱。

PathTooLongException

指定的路徑、檔案名稱或組合長度超過系統定義的最大長度。

SecurityException

來電者沒有所需的權限。

UnauthorizedAccessException

來電者沒有所需的權限。

備註

searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern

萬用字元指定器 比對
* （星號） 沒有或多個角色處於那個位置。
? (問號) 只有一個角色處於那個位置。

除了萬用卡以外的角色，都是字面上的字面角色。 例如， searchPattern 字串「*t」搜尋所有以 path 字母「t」結尾的名字。 searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。

Note

當你在像「*.txt」這樣的字元中使用星號萬用字 searchPattern 元時，指定副檔名中的字元數會影響搜尋結果，如下：

  • 若指定的副檔名正好為三個字元長，該方法會回傳以指定副檔名開頭的檔案。 例如，「*.xls」會回傳「book.xls」和「book.xlsx」。
  • 在其他所有情況下，該方法回傳的檔案都完全符合指定的副檔名。 例如，「*.ai」回傳「file.ai」，但不會回傳「file.aif」。

當你使用問號萬用字元時，這個方法只會回傳與指定副檔名相符的檔案。 例如，給定兩個檔案「file1.txt」和「file1.txtother」，在一個目錄中，搜尋模式為「file？」.txt“只會回傳第一個檔案，而搜尋「file*.txt」則會回傳兩個檔案。

searchPattern 不能以兩個句號（“..”）結尾，也不能包含兩個句號（“..”）後接 DirectorySeparatorChar 或 AltDirectorySeparatorChar，也不能包含任何無效字元。 你可以用這個 GetInvalidPathChars 方法查詢無效字元。

你可以用參數 path 來指定相對路徑資訊。 相對路徑資訊會被解讀為相對於目前工作目錄的資訊，你可以透過此 GetCurrentDirectory 方法來判斷。

EnumerateFileSystemEntries和 GetFileSystemEntries 方法的不同如下：當你使用 EnumerateFileSystemEntries時，可以在整個集合回傳前開始枚舉該集合;使用 GetFileSystemEntries時，必須等待整個陣列回傳完才能存取陣列。 因此，當你處理多個檔案和目錄時， EnumerateFileSystemEntries 效率會更高。

回傳的集合不會被快取;每次呼叫集合 GetEnumerator 都會開始新的列舉。

適用於