Collection.GetEnumerator Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

Collection.vb

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

public:
 System::Collections::IEnumerator ^ GetEnumerator();

public System.Collections.IEnumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Function GetEnumerator () As IEnumerator

Návraty

IEnumerator

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

Příklady

Následující příklad ukazuje, jak použít GetEnumerator k načtení všech prvků objektu Collection .

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 vytvoří a vrátí objekt enumerátoru, který implementuje IEnumerator rozhraní System.Collections oboru názvů. Objekt enumerátoru zveřejňuje Current vlastnost a MoveNext metody a Reset . Další informace najdete v tématu For Each... Next – příkaz.

Poznámky

Hodnota For Each... Volání Next PříkazGetEnumerator získat enumerátor objekt pro podporu iterace nad prvky kolekce. Za normálních okolností se k procházení kolekce nebo pole používá For Eachsmyčka ...Next a není nutné volat GetEnumerator explicitně.

Pokud potřebujete větší kontrolu nad iterací, než For Eachposkytují příkazy ...Next , můžete použít metodu GetEnumerator k provedení přizpůsobeného procházení. Tady jsou některé případy, ve kterých to možná budete muset udělat.

• Možná se budete chtít vrátit na začátek kolekce a před dokončením znovu spustit iteraci.

• Můžete chtít přeskočit jeden nebo více prvků z různých důvodů.

• Možná budete muset změnit prvky kolekce uprostřed procházení. V tomto případě musíte získat nový objekt enumerátoru, protože předchozí objekt je zneplatněný.