MatchCollection.IEnumerable<Match>.GetEnumerator Yöntem

Tanım

Ad Alanı:

System.Text.RegularExpressions

Bütünleştirilmiş Kod:

System.Text.RegularExpressions.dll

Source:

MatchCollection.cs

Toplulukta yinelenen bir numaralandırıcı döndürür.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>

Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumerator

Döndürülenler

IEnumerator<Match>

Koleksiyonda yinelemek için kullanılabilecek bir numaralandırıcı.

Uygulamalar

GetEnumerator()

Özel durumlar

NotSupportedException

Koleksiyon salt okunurdur.

Açıklamalar

döndürülen IEnumerator<T> , bir Current özelliğini açığa çıkartarak koleksiyonda yineleme olanağı sağlar. Bir koleksiyondaki verileri okumak için numaralandırıcıları kullanabilirsiniz, ancak koleksiyonu değiştirmek için kullanamazsınız. Başlangıçta, numaralandırıcı, koleksiyondaki ilk öğenin önüne yerleştirilir. Bu konumda tanımlanmamıştır Current . Bu nedenle, değerini Currentokumadan önce numaralandırıcıyı koleksiyonun ilk öğesine ilerletmek için yöntemini çağırmanız MoveNext gerekir. Current, bir sonraki öğeye küme olarak MoveNextCurrent yeniden çağrılana kadar MoveNext aynı nesneyi döndürür. Koleksiyonun sonunu geçerse MoveNext , numaralandırıcı koleksiyondaki son öğeden sonra konumlandırılır ve MoveNext döndürür false. Numaralandırıcı bu konumda olduğunda, sonraki çağrıları MoveNext da döndürür false. döndürülen falseCurrent son çağrı MoveNext tanımlanmamışsa. Koleksiyonun ilk öğesine yeniden ayarlayamazsınız Current ; bunun yerine yeni bir numaralandırıcı örneği oluşturmanız gerekir. Koleksiyonda öğe ekleme, değiştirme veya silme gibi değişiklikler yapılırsa, numaralandırıcının davranışı tanımlanmamıştır. Bir numaralandırıcının koleksiyona özel erişimi yoktur, bu nedenle bir numaralandırıcı, koleksiyon değişmediği sürece geçerli kalır. Koleksiyonda öğe ekleme, değiştirme veya silme gibi değişiklikler yapılırsa, numaralandırıcı geçersiz kılınmış olur ve beklenmeyen sonuçlar alabilirsiniz. Ayrıca, bir koleksiyonu numaralandırmak iş parçacığı açısından güvenli bir yordam değildir. İş parçacığı güvenliğini sağlamak için, numaralandırıcı sırasında koleksiyonu kilitlemeniz veya koleksiyonda eşitleme gerçekleştirmeniz gerekir. Ad alanında System.Collections.Generic koleksiyonların varsayılan uygulamaları eşitlenmez.