MatchCollection.IEnumerable<Match>.GetEnumerator Metoda

Definicja

Przestrzeń nazw:

System.Text.RegularExpressions

Zestaw:

System.Text.RegularExpressions.dll

Źródło:

MatchCollection.cs

Zwraca moduł wyliczający, który iteruje po kolekcji.

 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

Zwraca

IEnumerator<Match>

Moduł wyliczający, który może służyć do iterowania po kolekcji.

Implementuje

GetEnumerator()

Wyjątki

NotSupportedException

Kolekcja jest tylko do odczytu.

Uwagi

Zwrócony IEnumerator<T> element zapewnia możliwość iterowania przez kolekcję przez uwidacznianie Current właściwości . Moduły wyliczania umożliwiają odczytywanie danych w kolekcji, ale nie modyfikowanie kolekcji. Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji. Na tym stanowisku Current jest niezdefiniowany. W związku z tym należy wywołać metodę MoveNext , aby przejść do pierwszego elementu kolekcji przed odczytaniem wartości Current. Current zwraca ten sam obiekt, dopóki MoveNext obiekt nie zostanie ponownie wywołany jako MoveNext zestawy Current do następnego elementu. Jeśli MoveNext przejdzie koniec kolekcji, moduł wyliczający jest umieszczony po ostatnim elemecie w kolekcji i MoveNext zwraca wartość false. Gdy moduł wyliczający znajduje się na tym stanowisku, kolejne wywołania, aby MoveNext również zwrócić falsewartość . Jeśli ostatnie wywołanie, które MoveNext ma być zwrócone false, Current jest niezdefiniowane. Nie można ponownie ustawić Current pierwszego elementu kolekcji. Zamiast tego należy utworzyć nowe wystąpienie modułu wyliczającego. Jeśli zmiany są wprowadzane do kolekcji, takie jak dodawanie, modyfikowanie lub usuwanie elementów, zachowanie modułu wyliczającego jest niezdefiniowane. Moduł wyliczający nie ma wyłącznego dostępu do kolekcji, więc moduł wyliczający pozostaje ważny tak długo, jak kolekcja pozostaje niezmieniona. Jeśli zmiany zostaną wprowadzone w kolekcji, takie jak dodawanie, modyfikowanie lub usuwanie elementów, moduł wyliczający zostanie unieważniony i może zostać wyświetlony nieoczekiwany wynik. Ponadto wyliczanie kolekcji nie jest procedurą bezpieczną wątkowo. Aby zagwarantować bezpieczeństwo wątków, należy zablokować kolekcję podczas wyliczania lub zaimplementować synchronizację w kolekcji. Domyślne implementacje kolekcji w System.Collections.Generic przestrzeni nazw nie są synchronizowane.