Regex.GroupNumberFromName(String) 方法

定義

命名空間:

System.Text.RegularExpressions

組件:

System.Text.RegularExpressions.dll

組件:

System.dll

組件:

netstandard.dll

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

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。

例外狀況

ArgumentNullException

name 為 null。

備註

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

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

另請參閱

• GroupCollection
• GetGroupNames()
• 規則運算式中的群組建構