Regex.GroupNumberFromName(String) Yöntem

Tanım

Ad Alanı:

System.Text.RegularExpressions

Bütünleştirilmiş Kod:

System.Text.RegularExpressions.dll

Kaynak:

Regex.cs

Belirtilen grup adına karşılık gelen grup numarasını döndürür.

public:
 int GroupNumberFromName(System::String ^ name);

public int GroupNumberFromName (string name);

member this.GroupNumberFromName : string -> int

Public Function GroupNumberFromName (name As String) As Integer

Parametreler

name

String

İlgili grup numarasına dönüştürülecek grup adı.

Döndürülenler

Int32

Belirtilen grup adına karşılık gelen grup numarası veya geçerli bir grup adı değilse name -1.

Özel durumlar

ArgumentNullException

name, null değeridir.

Açıklamalar

Normal ifade deseni, bir desen eşleşmesi içindeki alt ifadeleri gösteren adlandırılmış veya numaralandırılmış yakalama grupları içerebilir. Numaralandırılmış gruplar söz dizimi (alt ifade) ile sınırlandırılır ve normal ifadedeki sıralarına göre sayılar atanır. Adlandırılmış gruplar söz dizimi (?<Adı>alt ifade) veya (?' name'subexpression), burada ad, alt ifadenin tanımlandığı addır. (Daha fazla bilgi için bkz. Gruplandırma Yapıları.) yöntemi, GroupNumberFromName hem adlandırılmış grupları hem de numaralandırılmış grupları normal ifadedeki sıralı konumlarına göre tanımlar. Sıralı konum sıfır her zaman normal ifadenin tamamını temsil eder. Ardından, normal ifade desenindeki gerçek konumlarından bağımsız olarak, tüm numaralandırılmış gruplar adlandırılmış gruplardan önce sayılır.

Normal ifade deseninde bulunan bir grup numarasının dize gösterimi ise name , yöntem bu sayıyı döndürür. Normal ifade deseninde bulunan adlandırılmış bir yakalama grubuna karşılık geliyorsa name , yöntem karşılık gelen numarasını döndürür. öğesinin name grup adıyla karşılaştırması büyük/küçük harfe duyarlıdır. Bir yakalama grubunun adına veya yakalama grubunun sayısının dize gösterimine karşılık gelmiyorsa name , yöntemi -1 döndürür.

Ayrıca bkz.

• GroupCollection
• GetGroupNames()
• Normal İfadelerdeki Gruplandırma Yapıları