CaptureCollection.IEnumerable<Capture>.GetEnumerator Metoda

Definice

Obor názvů:

System.Text.RegularExpressions

Sestavení:

System.Text.RegularExpressions.dll

Source:

CaptureCollection.cs

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

 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

Návraty

IEnumerator<Capture>

Enumerátor, který lze použít k iteraci prostřednictvím kolekce.

Implementuje

GetEnumerator()

Poznámky

Vrácený IEnumerator<T> objekt poskytuje možnost iterovat kolekcí zveřejněním Current vlastnosti . Můžete použít enumerátory ke čtení dat 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 není znovu volána jako MoveNext sady Current na další prvek. Pokud MoveNext projde konec kolekce, enumerátor se umístí za poslední prvek v kolekci a MoveNext vrátí false. Když je enumerátor na této pozici, následné volání také MoveNext vrátí false. 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 enumeratoru. 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ůstává platný, dokud kolekce zůstane nezměněna. Pokud jsou v kolekci provedeny změny, například přidání, úprava nebo odstranění prvků, je enumerátor zneplatněný a může dojít k neočekávaným výsledkům. Vytvoření výčtu kolekce také není procedurou bezpečnou pro přístup z více vláken. Chcete-li zajistit bezpečnost vláken, měli byste uzamknout kolekci během výčtu nebo implementovat synchronizaci kolekce. Výchozí implementace kolekcí v System.Collections.Generic oboru názvů se nesynchronují.