Regex.EnumerateMatches 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) |
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。 |
| EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions) |
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。 |
| EnumerateMatches(ReadOnlySpan<Char>) |
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。 |
| EnumerateMatches(ReadOnlySpan<Char>, Int32) |
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。 |
| EnumerateMatches(ReadOnlySpan<Char>, String) |
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。 |
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。
public:
static System::Text::RegularExpressions::Regex::ValueMatchEnumerator EnumerateMatches(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);public static System.Text.RegularExpressions.Regex.ValueMatchEnumerator EnumerateMatches (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);static member EnumerateMatches : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.Regex.ValueMatchEnumeratorPublic Shared Function EnumerateMatches (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Regex.ValueMatchEnumerator參數
- input
- ReadOnlySpan<Char>
要搜尋相符項目的範圍。
- pattern
- String
要比對的正則表達式模式。
- options
- RegexOptions
列舉值的位元組合，指定比對的選項。
- matchTimeout
- TimeSpan
超時時間間隔，或 InfiniteMatchTimeout，表示方法不應該逾時。
傳回
逐一查看相符專案的 Regex.ValueMatchEnumerator。
例外狀況
pattern
null。
options 不是 RegexOptions 值的有效位組合，或 matchTimeout 為負數、零或大於大約 24 天。
發生正則表達式剖析錯誤。
備註
在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。 由於對比對的評估會延遲執行，因此在呼叫 MoveNext() 之間傳入輸入的任何變更都會影響比對結果。 這個方法所傳回的列舉值，以及包裝輸入中每個相符專案之列舉值傳回的結構，都是 ref 結構，讓這個方法可以自由分攤配置。
適用於
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions)
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。
public:
static System::Text::RegularExpressions::Regex::ValueMatchEnumerator EnumerateMatches(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);public static System.Text.RegularExpressions.Regex.ValueMatchEnumerator EnumerateMatches (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);static member EnumerateMatches : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.Regex.ValueMatchEnumeratorPublic Shared Function EnumerateMatches (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Regex.ValueMatchEnumerator參數
- input
- ReadOnlySpan<Char>
要搜尋相符項目的範圍。
- pattern
- String
要比對的正則表達式模式。
- options
- RegexOptions
列舉值的位元組合，指定比對的選項。
傳回
逐一查看相符專案的 Regex.ValueMatchEnumerator。
例外狀況
pattern
null。
options 不是 RegexOptions 值的有效位組合。
發生正則表達式剖析錯誤。
備註
在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。 由於對比對的評估會延遲執行，因此在呼叫 MoveNext() 之間傳入輸入的任何變更都會影響比對結果。 這個方法所傳回的列舉值，以及包裝輸入中每個相符專案之列舉值傳回的結構，都是 ref 結構，讓這個方法可以自由分攤配置。
適用於
EnumerateMatches(ReadOnlySpan<Char>)
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。
public:
System::Text::RegularExpressions::Regex::ValueMatchEnumerator EnumerateMatches(ReadOnlySpan<char> input);public System.Text.RegularExpressions.Regex.ValueMatchEnumerator EnumerateMatches (ReadOnlySpan<char> input);member this.EnumerateMatches : ReadOnlySpan<char> -> System.Text.RegularExpressions.Regex.ValueMatchEnumeratorPublic Function EnumerateMatches (input As ReadOnlySpan(Of Char)) As Regex.ValueMatchEnumerator參數
- input
- ReadOnlySpan<Char>
要搜尋相符項目的範圍。
傳回
逐一查看相符專案的 Regex.ValueMatchEnumerator。
備註
在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。 由於對比對的評估會延遲執行，因此在呼叫 MoveNext() 之間傳入輸入的任何變更都會影響比對結果。 這個方法所傳回的枚舉器，以及包裝輸入中每個相符專案之列舉值所傳回的結構都是 ref 結構，讓這個方法可以自由攤銷配置。
適用於
EnumerateMatches(ReadOnlySpan<Char>, Int32)
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。
public:
System::Text::RegularExpressions::Regex::ValueMatchEnumerator EnumerateMatches(ReadOnlySpan<char> input, int startat);public System.Text.RegularExpressions.Regex.ValueMatchEnumerator EnumerateMatches (ReadOnlySpan<char> input, int startat);member this.EnumerateMatches : ReadOnlySpan<char> * int -> System.Text.RegularExpressions.Regex.ValueMatchEnumeratorPublic Function EnumerateMatches (input As ReadOnlySpan(Of Char), startat As Integer) As Regex.ValueMatchEnumerator參數
- input
- ReadOnlySpan<Char>
要搜尋相符項目的範圍。
- startat
- Int32
要開始搜尋之以零起始的字元位置。
傳回
逐一查看相符專案的 Regex.ValueMatchEnumerator。
備註
在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。 由於對比對的評估會延遲執行，因此在呼叫 MoveNext() 之間傳入輸入的任何變更都會影響比對結果。 傳回的列舉值和列舉值所傳回的結構，這些列舉值會包裝輸入中找到的每個相符專案，都是 ref 結構，讓這個方法可以自由攤銷配置。
適用於
EnumerateMatches(ReadOnlySpan<Char>, String)
搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueMatchEnumerator 逐一查看相符專案。
public:
static System::Text::RegularExpressions::Regex::ValueMatchEnumerator EnumerateMatches(ReadOnlySpan<char> input, System::String ^ pattern);public static System.Text.RegularExpressions.Regex.ValueMatchEnumerator EnumerateMatches (ReadOnlySpan<char> input, string pattern);static member EnumerateMatches : ReadOnlySpan<char> * string -> System.Text.RegularExpressions.Regex.ValueMatchEnumeratorPublic Shared Function EnumerateMatches (input As ReadOnlySpan(Of Char), pattern As String) As Regex.ValueMatchEnumerator參數
- input
- ReadOnlySpan<Char>
要搜尋相符項目的範圍。
- pattern
- String
要比對的正則表達式模式。
傳回
逐一查看相符專案的 Regex.ValueMatchEnumerator。
例外狀況
pattern
null。
發生正則表達式剖析錯誤。
備註
在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。 由於對比對的評估會延遲執行，因此在呼叫 MoveNext() 之間傳入輸入的任何變更都會影響比對結果。 這個方法所傳回的列舉值，以及包裝輸入中每個相符專案之列舉值傳回的結構，都是 ref 結構，讓這個方法可以自由分攤配置。
