Udostępnij za pośrednictwem


CaptureCollection.IEnumerable<Capture>.GetEnumerator Metoda

Definicja

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

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Capture ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Capture ^>::GetEnumerator;
System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture> IEnumerable<Capture>.GetEnumerator ();
abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
Function GetEnumerator () As IEnumerator(Of Capture) Implements IEnumerable(Of Capture).GetEnumerator

Zwraca

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

Implementuje

Uwagi

Zwrócony IEnumerator<T> element umożliwia iterowanie kolekcji 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 Metoda zwraca ten sam obiekt do MoveNext momentu wywołania go ponownie jako MoveNext zestawów Current do następnego elementu. Jeśli MoveNext przejdzie koniec kolekcji, moduł wyliczający zostanie umieszczony po ostatnim elemecie w kolekcji i MoveNext zwróci 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 zwracane MoveNextfalse, Current jest niezdefiniowane. Nie można ponownie ustawić Current elementu na pierwszy element kolekcji. Zamiast tego należy utworzyć nowe wystąpienie modułu wyliczającego. Jeśli w kolekcji zostaną wprowadzone zmiany, 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, o ile kolekcja pozostaje niezmieniona. Jeśli wprowadzono zmiany 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.

Dotyczy