Match Sınıf

Tanım

Ad Alanı:

System.Text.RegularExpressions

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Text.RegularExpressions.dll

Kaynak:

Match.cs

Tek bir normal ifade eşleşmesinin sonuçlarını temsil eder.

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

Devralma

Object

Capture

Group

Match

Açıklamalar

Sınıfı Match sabittir ve ortak oluşturucusunun olmaması. sınıfının bir örneği Match yöntemi tarafından Match(String) döndürülür ve bir dizedeki ilk desen eşleşmesini temsil eder. Sonraki eşleşmeler yöntemi tarafından döndürülen nesnelerle Match temsil edilirNextMatch(). Ayrıca, sıfır, bir veya daha fazla MatchCollection nesneden oluşan bir Match nesne yöntemi tarafından Matches(String) döndürülür.

Matches(String) Yöntem bir giriş dizesindeki normal ifade deseni ile eşleşmezse boş MatchCollection bir nesne döndürür. Daha sonra koleksiyonu yinelemek için bir foreach yapı kullanabilirsiniz.

Match(String) Yöntem normal ifade deseni ile eşleşmezse, öğesine eşit Matchbir Empty nesne döndürür. Eşleşmenin Success başarılı olup olmadığını belirlemek için özelliğini kullanabilirsiniz.

Bir desen eşleşmesi başarılı olursa, Value özelliği eşleşen alt dizeyi içerir, Index özelliği giriş dizesinde eşleşen alt dizenin sıfır tabanlı başlangıç konumunu gösterir ve Length özellik de giriş dizesindeki eşleşen alt dizenin uzunluğunu gösterir.

Tek bir eşleşme birden çok yakalama grubu içerebileceğinden, Match öğesini döndüren Groupsbir GroupCollection özelliği vardır. Örneğin Match kendisi, Match.Groups[0]koleksiyonundaki tüm eşleşmeyi temsil eden ilk nesneye eşdeğerdir.

Özellikler

Name	Description
Captures	Yakalama grubuyla eşleşen tüm yakalamaların en soldaki ilk sırada (veya normal ifade seçeneğiyle RightToLeft değiştirildiğinde en içteki en sağdaki ilk sırada) eşleşen tüm yakalamaların koleksiyonunu alır. Koleksiyonda sıfır veya daha fazla öğe olabilir. (Devralındığı yer: Group)
Empty	Boş eşleşmeyi alır. Tüm başarısız eşleşmeler bu boş eşleşmeyi döndürür.
Groups	Normal ifadeyle eşleşen grup koleksiyonunu alır.
Index	Yakalanan alt dizenin ilk karakterinin bulunduğu özgün dizedeki konumu alır. (Devralındığı yer: Capture)
Length	Yakalanan alt dizenin uzunluğunu alır. (Devralındığı yer: Capture)
Name	Geçerli örnek tarafından temsil edilen yakalama grubunun adını döndürür. (Devralındığı yer: Group)
Success	Eşleşmenin başarılı olup olmadığını gösteren bir değer alır. (Devralındığı yer: Group)
Value	Yakalanan alt dizeyi giriş dizesinden alır. (Devralındığı yer: Capture)
ValueSpan	Yakalanan yayılma süresini giriş dizesinden alır. (Devralındığı yer: Capture)

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
NextMatch()	Son eşleşmenin sona erdiği konumdan (son eşleşen karakterden sonraki karakterde) başlayarak sonraki eşleşmenin sonuçlarını içeren yeni Match bir nesne döndürür.
Result(String)	Geçirilen değiştirme deseninin genişlemesini döndürür. Örneğin, değiştirme deseni ise $1$2Result(String) ve Groups[2].Valuebirleştirmesini Groups[1].Value döndürür.
Synchronized(Match)	Birden çok iş parçacığı arasında paylaşılırken güvenli olan, sağlanan örnekle eşdeğer bir Match örnek döndürür.
ToString()	Özelliğini çağırarak giriş dizesinden yakalanan alt dizeyi Value alır. (Devralındığı yer: Capture)

Ayrıca bkz.

• MatchCollection
• Regex