Regex.EnumerateSplits 方法

參考

定義

命名空間:: System.Text.RegularExpressions

組件:: System.Text.RegularExpressions.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

EnumerateSplits(ReadOnlySpan<Char>)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。
EnumerateSplits(ReadOnlySpan<Char>, Int32)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。
EnumerateSplits(ReadOnlySpan<Char>, String)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

EnumerateSplits(ReadOnlySpan<Char>)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input);

member this.EnumerateSplits : ReadOnlySpan<char> -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char)) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的 Regex.ValueSplitEnumerator。

備註

EnumerateSplits(ReadOnlySpan<Char>) 的行為類似於 Split(String)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>) 則不會。如果指定了 RightToLeft，Split(String) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>) 會以從右至左的順序產生分割。

在列舉值上叫用 MoveNext() 之前，每個比對實際上都不會發生，每個 MoveNext() 呼叫都會執行一個相符專案。由於對比對的評估會延遲進行，因此對呼叫之間傳入輸入的任何變更，MoveNext() 可能會影響比對結果：應避免這類變更，且不受支援。

適用於

EnumerateSplits(ReadOnlySpan<Char>, Int32)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, int count);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, int count);

member this.EnumerateSplits : ReadOnlySpan<char> * int -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

count: Int32

分割可以發生的次數上限。如果為 0，則所有分割都可以使用。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的 Regex.ValueSplitEnumerator。

備註

EnumerateSplits(ReadOnlySpan<Char>, Int32) 的行為類似於 Split(String, Int32)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String, Int32) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>, Int32) 則不會。如果指定了 RightToLeft，Split(String, Int32) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>, Int32) 會以從右至左的順序產生分割。

適用於

EnumerateSplits(ReadOnlySpan<Char>, String)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern);

static member EnumerateSplits : ReadOnlySpan<char> * string -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

pattern: String

要比對的正則表達式模式。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的分割 Regex.ValueSplitEnumerator。

例外狀況

ArgumentNullException

pattern null。

RegexParseException

發生正則表達式剖析錯誤。

備註

EnumerateSplits(ReadOnlySpan<Char>, String) 的行為類似於 Split(String, String)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String, String) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>, String) 則不會。如果指定了 RightToLeft，Split(String, String) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>, String) 會以從右至左的順序產生分割。

適用於

EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, int count, int startat);

public System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, int count, int startat);

member this.EnumerateSplits : ReadOnlySpan<char> * int * int -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Function EnumerateSplits (input As ReadOnlySpan(Of Char), count As Integer, startat As Integer) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

count: Int32

分割可以發生的次數上限。如果為 0，則所有分割都可以使用。

startat: Int32

要開始搜尋之以零起始的字元位置。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的 Regex.ValueSplitEnumerator。

備註

EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 的行為類似於 Split(String, Int32, Int32)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String, Int32, Int32) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 則不會。如果指定了 RightToLeft，Split(String, Int32, Int32) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32) 會以從右至左的順序產生分割。

適用於

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member EnumerateSplits : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

pattern: String

要比對的正則表達式模式。

options: RegexOptions

列舉值的位元組合，指定比對的選項。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的分割 Regex.ValueSplitEnumerator。

例外狀況

ArgumentNullException

pattern null。

ArgumentOutOfRangeException

options 不是 RegexOptions 值的有效位組合。

RegexParseException

發生正則表達式剖析錯誤。

備註

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 的行為類似於 Split(String, String, RegexOptions)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String, String, RegexOptions) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 則不會。如果指定了 RightToLeft，Split(String, String, RegexOptions) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions) 會以從右至左的順序產生分割。

適用於

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

搜尋輸入範圍中所有出現的正則表達式，並傳回 Regex.ValueSplitEnumerator 逐一查看相符專案的分割。

public:
 static System::Text::RegularExpressions::Regex::ValueSplitEnumerator EnumerateSplits(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static System.Text.RegularExpressions.Regex.ValueSplitEnumerator EnumerateSplits (ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member EnumerateSplits : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.Regex.ValueSplitEnumerator

Public Shared Function EnumerateSplits (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Regex.ValueSplitEnumerator

參數

input: ReadOnlySpan<Char>

要搜尋相符項目的範圍。

pattern: String

要比對的正則表達式模式。

options: RegexOptions

列舉值的位元組合，指定比對的選項。

matchTimeout: TimeSpan

超時時間間隔，或 InfiniteMatchTimeout，表示方法不應該逾時。

傳回

Regex.ValueSplitEnumerator

逐一查看相符專案的分割 Regex.ValueSplitEnumerator。

例外狀況

ArgumentNullException

pattern null。

ArgumentOutOfRangeException

options 不是 RegexOptions 值的有效位組合，或 matchTimeout 為負數、零或大於大約 24 天。

RegexParseException

發生正則表達式剖析錯誤。

備註

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 的行為類似於 Split(String, String, RegexOptions, TimeSpan)的行為，一次產生一個分割，做為逐一查看產生的列舉值，而不是一次做為單一陣列的一部分。不過，有幾個值得注意的差異。 Split(String, String, RegexOptions, TimeSpan) 會在產生的分割中包含擷取群組的內容，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 則不會。如果指定了 RightToLeft，Split(String, String, RegexOptions, TimeSpan) 會反轉結果分割的順序為由左至右，而 EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) 會以從右至左的順序產生分割。

適用於

共用方式為

Regex.EnumerateSplits 方法

定義

多載

EnumerateSplits(ReadOnlySpan<Char>)

參數

傳回

備註

適用於

EnumerateSplits(ReadOnlySpan<Char>, Int32)

參數

傳回

備註

適用於

EnumerateSplits(ReadOnlySpan<Char>, String)

參數

傳回

例外狀況

備註

適用於

EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

參數

傳回

備註

適用於

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

參數

傳回

例外狀況

備註

適用於

EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

參數

傳回

例外狀況

備註

適用於

其他資源