Collection.GetEnumerator Metódus

Definíció

Egy enumerátort ad vissza, amely a gyűjteményen keresztül iterál.

public:
 System::Collections::IEnumerator ^ GetEnumerator();
public System.Collections.IEnumerator GetEnumerator();
member this.GetEnumerator : unit -> System.Collections.IEnumerator
Public Function GetEnumerator () As IEnumerator

Válaszok

Enumerátor, amely a gyűjteményen keresztüli iterálásra használható.

Példák

Az alábbi példa bemutatja, hogyan lehet lekérni GetEnumerator egy Collection objektum összes elemét.

Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
    thisCustomer = custEnum.Current()
    ' Insert code to process this element of the collection.
End While

GetEnumerator egy enumerátor objektumot hoz létre és ad vissza, amely megvalósítja a IEnumeratorSystem.Collections névtér illesztőfelületét. Az enumerátor objektum elérhetővé teszi a Current tulajdonságot és a MoveNextReset metódusokat. További információ: Minden egyes... Következő utasítás.

Megjegyzések

Az egyes... A Következő utasítás egy enumerátor objektum beszerzését kéri GetEnumerator a gyűjtemény elemeinek iterálásának támogatásához. Általában egy ... hurkot For Eachhasznál egy gyűjtemény vagy tömb bejárásához, és nem kell explicit módon meghívniaNext.GetEnumerator

Ha a ...For Each utasításokkal megadottnál szorosabban kell szabályoznia az Nextiterációt, a GetEnumerator metódussal testre szabott bejárást hajthat végre. Az alábbiakban néhány esetben előfordulhat, hogy ezt meg kell tennie.

  • Előfordulhat, hogy vissza szeretne térni a gyűjtemény elejére, és a befejezés előtt újra elindítani az iterációt.

  • Több okból is érdemes lehet átugorni egy vagy több elemet.

  • Előfordulhat, hogy módosítania kell a gyűjtemény elemeit egy bejárás közepén. Ebben az esetben be kell szereznie egy új enumerátorobjektumot, mert az előző érvénytelen.

A következőre érvényes: