DirectoryInfo.EnumerateFileSystemInfos 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳目前目錄中可枚舉的檔案系統資訊集合。
多載
| 名稱 | Description |
|---|---|
| EnumerateFileSystemInfos(String, SearchOption) |
回傳一組可列舉的檔案系統資訊，符合指定的搜尋模式及搜尋子目錄選項。 |
| EnumerateFileSystemInfos() |
回傳目前目錄中可枚舉的檔案系統資訊集合。 |
| EnumerateFileSystemInfos(String) |
回傳一組可枚舉的檔案系統資訊，符合指定的搜尋模式。 |
| EnumerateFileSystemInfos(String, EnumerationOptions) |
回傳一個可枚舉的檔案系統資訊集合，符合指定的搜尋模式與列舉選項。 |
EnumerateFileSystemInfos(String, SearchOption)
回傳一組可列舉的檔案系統資訊，符合指定的搜尋模式及搜尋子目錄選項。
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
列舉值之一，指定搜尋操作應只包含目前目錄還是所有子目錄。 預設值為 TopDirectoryOnly。
傳回
一個可枚舉的檔案系統資訊物件集合，與 和 相符searchPatternsearchOption。
例外狀況
searchPattern 是 null。
searchOption 不是一個有效的 SearchOption 值。
封裝在 DirectoryInfo 物件中的路徑無效（例如，它位於未映射的磁碟上）。
來電者沒有所需的權限。
備註
searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern
| 萬用字元指定器 | 比對 |
|---|---|
| * （星號） | 沒有或多個角色處於那個位置。 |
| ? (問號) | 那個位置沒有角色。 |
除了萬用卡以外的角色，都是字面上的字面角色。 例如，字串「*t」搜尋所有以字母「t」結尾的名字。 ".
searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。
EnumerateFileSystemInfos和 GetFileSystemInfos 方法不同，如下所示：
當你使用 EnumerateFileSystemInfos時，可以在整個集合還沒回傳之前，先開始枚舉物件集合 FileSystemInfo 。
當你使用 GetFileSystemInfos時，必須等待整個物件陣列 FileSystemInfo 回傳完才能存取該陣列。
因此，當你處理多個檔案和目錄時， EnumerateFileSystemInfos 效率會更高。
此方法預先填充以下 FileSystemInfo 屬性的值：
回傳的集合不會被快取;每次呼叫 GetEnumerator 集合上的方法都會開始新的列舉。
另請參閱
適用於
EnumerateFileSystemInfos()
回傳目前目錄中可枚舉的檔案系統資訊集合。
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)傳回
目前目錄中可列舉的檔案系統資訊集合。
例外狀況
封裝在 DirectoryInfo 物件中的路徑無效（例如，它位於未映射的磁碟上）。
來電者沒有所需的權限。
備註
EnumerateFileSystemInfos和 GetFileSystemInfos 方法不同，如下所示：
當你使用 EnumerateFileSystemInfos時，可以在整個集合還沒回傳之前，先開始枚舉物件集合 FileSystemInfo 。
當你使用 GetFileSystemInfos時，必須等待整個物件陣列 FileSystemInfo 回傳完才能存取該陣列。
因此，當你處理多個檔案和目錄時， EnumerateFileSystemInfos 效率會更高。
此方法預先填充以下 FileSystemInfo 屬性的值：
回傳的集合不會被快取;每次呼叫 GetEnumerator 集合上的方法都會開始新的列舉。
另請參閱
適用於
EnumerateFileSystemInfos(String)
回傳一組可枚舉的檔案系統資訊，符合指定的搜尋模式。
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
搜尋字串用來與目錄名稱相符。 此參數可包含有效的文字路徑與通配符（* 與 ？）字元，但不支援正則表達式。
傳回
一個可枚舉的檔案系統資訊物件集合，與 相符 searchPattern。
例外狀況
searchPattern 是 null。
封裝在 DirectoryInfo 物件中的路徑無效（例如，它位於未映射的磁碟上）。
來電者沒有所需的權限。
備註
searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern
| 萬用字元指定器 | 比對 |
|---|---|
| * （星號） | 沒有或多個角色處於那個位置。 |
| ? (問號) | 那個位置沒有角色。 |
除了萬用卡以外的角色，都是字面上的字面角色。 例如，字串「*t」搜尋所有以字母「t」結尾的名字。 ".
searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。
EnumerateFileSystemInfos和 GetFileSystemInfos 方法不同，如下所示：
當你使用 EnumerateFileSystemInfos時，可以在整個集合還沒回傳之前，先開始枚舉物件集合 FileSystemInfo 。
當你使用 GetFileSystemInfos時，必須等待整個物件陣列 FileSystemInfo 回傳完才能存取該陣列。
因此，當你處理多個檔案和目錄時， EnumerateFileSystemInfos 效率會更高。
此方法預先填充以下 FileSystemInfo 屬性的值：
回傳的集合不會被快取;每次呼叫 GetEnumerator 集合上的方法都會開始新的列舉。
另請參閱
適用於
EnumerateFileSystemInfos(String, EnumerationOptions)
回傳一個可枚舉的檔案系統資訊集合，符合指定的搜尋模式與列舉選項。
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
一個描述搜尋與列舉配置的物件。
傳回
一個可枚舉的檔案系統資訊物件集合，與 和 相符searchPatternenumerationOptions。
例外狀況
searchPattern 是 null。
封裝在 DirectoryInfo 物件中的路徑無效（例如，它位於未映射的磁碟上）。
來電者沒有所需的權限。
備註
searchPattern 它可以是字面字元和萬用字元的組合，但它不支援正則表達式。 以下允許的萬用字元規定符。searchPattern
| 萬用字元指定器 | 比對 |
|---|---|
| * （星號） | 沒有或多個角色處於那個位置。 |
| ? (問號) | 那個位置沒有角色。 |
除了萬用卡以外的角色，都是字面上的字面角色。 例如，字串「*t」搜尋所有以字母「t」結尾的名字。 ".
searchPattern字串「s*」搜尋所有以字母「s」開頭的path名稱。
EnumerateFileSystemInfos和 GetFileSystemInfos 方法不同，如下所示：
當你使用 EnumerateFileSystemInfos時，可以在整個集合還沒回傳之前，先開始枚舉物件集合 FileSystemInfo 。
當你使用 GetFileSystemInfos時，必須等待整個物件陣列 FileSystemInfo 回傳完才能存取該陣列。
因此，當你處理多個檔案和目錄時， EnumerateFileSystemInfos 效率會更高。
此方法預先填充以下 FileSystemInfo 屬性的值：
回傳的集合不會被快取;每次呼叫 GetEnumerator 集合上的方法都會開始新的列舉。
