Collection.GetEnumerator Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.IEnumeratorPublic Function GetEnumerator () As IEnumeratorNávraty
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ý.
