ActivityCollection.GetEnumerator Metoda

Definice

Obor názvů:

System.Workflow.ComponentModel

Sestavení:

System.Workflow.ComponentModel.dll

Implementuje rozhraní výčtu ICollectiondo .

public:
 System::Collections::Generic::IEnumerator<System::Workflow::ComponentModel::Activity ^> ^ GetEnumerator();

public System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity> GetEnumerator();

override this.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity>

Public Function GetEnumerator () As IEnumerator(Of Activity)

Návraty

IEnumerator<Activity>

Enumerátor, který může iterovat prostřednictvím ReadOnlyCollectionBase instance.

Implementuje

GetEnumerator()

Poznámky

Enumerátory umožňují čtení pouze dat v kolekci. K úpravě podkladové kolekce nelze použít enumerátory.

Pro začátek je enumerátor umístěn před prvním prvkem v kolekci. Reset také vrátí enumerátor zpět do této pozice. Volání v této pozici Current vyvolá výjimku. Proto je nutné volat MoveNext , aby se enumerátor před čtením hodnoty Current.

Current vrátí stejný objekt, dokud se nevolá MoveNext nebo Reset nevolá. MoveNext nastaví Current na další prvek.

Po předání konce kolekce je enumerátor umístěn za posledním prvkem v kolekci a volání MoveNext vrátí false. Pokud se vrátí poslední voláníMoveNext, vyvolá volání falseCurrentvýjimku.

Chcete-li nastavit Current na první prvek kolekce znovu, můžete volat Reset následovaný MoveNext.

Enumerátor zůstane platný, dokud kolekce zůstane beze změny. Pokud jsou v kolekci provedeny změny, například přidání, úpravy nebo odstranění prvků, enumerátor je nevratně neplatný a další volání MoveNext nebo Reset vyvolá InvalidOperationException . Pokud je kolekce změněna mezi MoveNext a Current, Current vrátí prvek, na který je nastavena, i když je enumerátor již neplatný.

Enumerátor nemá výhradní přístup k kolekci; proto výčet prostřednictvím kolekce není vnitřně bezpečným postupem pro přístup z více vláken. I když je kolekce synchronizována, můžou ostatní vlákna kolekci i nadále upravovat. To způsobí, že enumerátor vyvolá výjimku. Chcete-li zaručit bezpečnost vláken během výčtu, můžete buď uzamknout kolekci během celého výčtu, nebo zachytit výjimky vyplývající z změn provedených jinými vlákny.