Match 類別

定義

命名空間:

System.Text.RegularExpressions

組件:

netstandard.dll, System.Text.RegularExpressions.dll

來源:

Match.cs

表示單一正則表示式比對的結果。

public ref class Match : System::Text::RegularExpressions::Group

public class Match : System.Text.RegularExpressions.Group

type Match = class
    inherit Group

Public Class Match
Inherits Group

繼承

Object

Capture

Group

Match

備註

此 Match 類別為不可變且無公共建構子。 該類別的一個實例 Match 會由 Match(String) 方法回傳，代表字串中的第一個模式匹配。 後續的匹配則由 Match 該方法回傳 NextMatch() 的物件表示。 此外，MatchCollection方法會回傳Match由零、一個或多個Matches(String)物件組成的物件。

若 Matches(String) 方法未能匹配輸入字串中的正則表達式模式，則回傳一個空 MatchCollection 物件。 接著你可以用結構 foreach 來遍歷集合。

若 Match(String) 方法無法符合正則表達式模式，則回傳一個 Match 等 Empty於 的物件。 你可以利用該 Success 物業來判斷配對是否成功。

若模式匹配成功， Value 屬性包含匹配的子字串，屬性 Index 表示匹配子串在輸入字串中的零起始位置，屬性 Length 表示匹配子字串在輸入字串中的長度。

由於單一匹配可能涉及多個捕獲群組， Match 具有 Groups 返回 的屬性。GroupCollection 該 Match 實例本身等價於集合中的第一個物件，該 Match.Groups[0]物件代表整個匹配。

屬性

名稱	Description
Captures	取得捕獲群所匹配的所有捕獲集合，依最內左至第一順序（或若正則表達式有 RightToLeft 選項修改則為最內至最右一順序）。 收藏中可能沒有或更多項目。 (繼承來源 Group)
Empty	拿到空火柴。 所有失敗的配對會返回此空配對。
Groups	得到一組由正則表達式匹配的群。
Index	取得原始字串中捕獲子串第一個字元的位置。 (繼承來源 Capture)
Length	取得捕獲子串的長度。 (繼承來源 Capture)
Name	回傳目前實例所代表的捕獲群組名稱。 (繼承來源 Group)
Success	獲得一個表示配對是否成功的值。 (繼承來源 Group)
Value	從輸入字串取得擷取的子字串。 (繼承來源 Capture)
ValueSpan	從輸入字串取得擷取的 span。 (繼承來源 Capture)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
NextMatch()	回傳一個新 Match 物件，顯示下一場比賽的結果，從上一場比賽結束的位置開始（即最後一位配對角色後的角色）。
Result(String)	回傳已通過的替換模式的展開。 例如，若替換模式為 $1$2，Result(String)則回傳 與 Groups[2].Value的串接。Groups[1].Value
Synchronized(Match)	回傳 Match 一個與所提供實例相當，且安全可於多個執行緒間共享的實例。
ToString()	透過呼叫 Value 屬性，從輸入字串中擷取的子字串。 (繼承來源 Capture)

另請參閱

• MatchCollection
• Regex