MatchCollection.IEnumerable<Match>.GetEnumerator Metoda

Definice

Obor názvů:

System.Text.RegularExpressions

Sestavení:

System.Text.RegularExpressions.dll

Source:

MatchCollection.cs

Získá enumerátor, který provádí iteraci v kolekci.

 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

Návraty

IEnumerator<Match>

Enumerátor, který lze použít k iteraci kolekcí.

Implementuje

GetEnumerator()

Výjimky

NotSupportedException

Kolekce je jen pro čtení.

Poznámky

IEnumerator<T> Vrácený objekt poskytuje možnost iterovat kolekci zveřejněním Current vlastnosti . Pomocí enumerátorů můžete číst data v kolekci, ale ne k úpravě kolekce. Zpočátku je enumerátor umístěn před prvním prvkem v kolekci. Na této pozici Current není definován. Proto je nutné volat metodu MoveNext pro přechod enumerátoru na první prvek kolekce před čtením hodnoty Current. Current vrátí stejný objekt, dokud MoveNext se znovu nevolá jako MoveNext sady Current na další prvek. Pokud MoveNext přejde na konec kolekce, enumerátor se umístí za poslední prvek v kolekci a MoveNext vrátí false. Pokud je enumerátor na této pozici, další volání MoveNext vrátí falsetaké . Pokud je poslední volání MoveNext vráceno false, Current není definováno. Nelze znovu nastavit Current na první prvek kolekce; místo toho musíte vytvořit novou instanci enumerátoru. Pokud jsou v kolekci provedeny změny, například přidání, úprava nebo odstranění prvků, chování enumerátoru není definováno. Enumerátor nemá výhradní přístup ke kolekci, takže enumerátor zůstane platný, dokud kolekce zůstane beze změny. Pokud jsou v kolekci provedeny změny, například přidání, úprava nebo odstranění prvků, je výčet neplatný a může dojít k neočekávaným výsledkům. Výčet kolekce také není procedurou bezpečnou pro přístup z více vláken. Abyste zajistili bezpečnost vláken, měli byste kolekci uzamknout během enumerátoru nebo implementovat synchronizaci v kolekci. Výchozí implementace kolekcí v System.Collections.Generic oboru názvů se nesynchronují.