共用方式為


Regex.GroupNumberFromName(String) 方法

定義

傳回對應指定群組名稱的群組編號。

public:
 int GroupNumberFromName(System::String ^ name);
public int GroupNumberFromName (string name);
member this.GroupNumberFromName : string -> int
Public Function GroupNumberFromName (name As String) As Integer

參數

name
String

群組名稱,要轉換至對應群組編號的。

傳回

Int32

對應指定群組名稱的群組編號;如果 name 不是有效的群組名稱,則為 -1。

例外狀況

namenull

備註

正則運算式模式可能包含具名或編號的擷取群組,以在模式比對內描述子運算式。 編號群組是以 子運算式 (子運算式) 的語法分隔,並根據正則運算式中的順序指派數位。 具名群組是以語法 (分隔? <名字 >subexpression) 或 (?'** name'subexpression) ,其中 name 是用來識別 subexpression 的名稱。** (如需詳細資訊,請參閱 Grouping Constructs.) 方法 GroupNumberFromName 會依正則運算式中的序數位置識別具名群組和編號群組。 序數位置零一律代表整個正則運算式。 然後,所有編號的群組都會計算在具名群組之前,不論其在正則運算式模式中的實際位置為何。

如果 name 是正則運算式模式中存在之群組編號的字串標記法,則方法會傳回該數位。 如果 name 對應至正則運算式模式中存在的具名擷取群組,則方法會傳回其對應的數位。 與組名的比較 name 會區分大小寫。 如果 name 未對應到擷取群組的名稱或擷取群組數目的字串標記法,方法會傳回 -1。

適用於

另請參閱