Match.Groups 屬性

定義

命名空間:

System.Text.RegularExpressions

組件:

netstandard.dll, System.Text.RegularExpressions.dll

來源:

Match.cs

得到一組由正則表達式匹配的群。

public:
 virtual property System::Text::RegularExpressions::GroupCollection ^ Groups { System::Text::RegularExpressions::GroupCollection ^ get(); };

public virtual System.Text.RegularExpressions.GroupCollection Groups { get; }

member this.Groups : System.Text.RegularExpressions.GroupCollection

Public Overridable ReadOnly Property Groups As GroupCollection

屬性值

GroupCollection

角色群組依圖案相匹配。

備註

正則表達式模式可以包含子表達式，這些子表達式是用括號包住正則表達式模式的一部分來定義的。 每個這樣的子表達式都形成一個群。 該 Groups 屬性提供關於這些子表達式匹配的資訊。 例如，正則表達式模式 (\d{3})-(\d{3}-\d{4})，與北美電話號碼相符，包含兩個子表達式。 第一種是區碼，包含電話號碼的前三位數字。 此群由第一組括號 (\d{3})所捕捉。 第二部分包含電話號碼，包含電話號碼的最後七位數字。 此群由第二組括號 (\d{3}-\d{4})所捕捉。

屬性回傳GroupCollection的Groups物件總是至少有一個成員。 如果正則表達式引擎找不到特定輸入字串中的匹配，集合中的單一 Group 物件屬性設 Group.Success 為 ， false 屬性 Group.Value 設 Empty為 。

若集合中有多個成員，集合中的第一個項目與物件 Match 相同（整個匹配）。 每個後續成員代表一個被捕獲的群，若正則表達式包含捕獲群。 群可以透過整數索引存取，或對已命名群依名稱存取。