Collection.GetEnumerator Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar en uppräkning som itererar genom samlingen.
public:
System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();member this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorReturer
En uppräkning som kan användas för att iterera genom samlingen.
Exempel
I följande exempel visas hur du använder GetEnumerator för att hämta alla element i ett Collection objekt.
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 konstruerar och returnerar ett uppräkningsobjekt som implementerar namnområdets IEnumerator gränssnitt System.Collections . Uppräkningsobjektet exponerar Current egenskapen och MoveNext metoderna och Reset . Mer information finns i För varje... Nästa instruktion.
Kommentarer
För varje... Nästa instruktion anropar GetEnumerator för att hämta ett uppräkningsobjekt som stöder iteration över en samlings element. Normalt använder du en For Each...Next -loop för att bläddra i en samling eller matris, och du behöver inte anropa GetEnumerator explicit.
Om du behöver närmare kontroll över iterationen än vad ...For Each -uttrycken Nextanger kan du använda GetEnumerator metoden för att utföra en anpassad bläddring. Följande är några fall där du kan behöva göra detta.
Du kanske vill återgå till början av samlingen och starta iterationen igen innan den är klar.
Du kanske vill hoppa över ett eller flera element av olika skäl.
Du kan behöva ändra elementen i samlingen mitt i en bläddering. I det här fallet måste du skaffa ett nytt uppräkningsobjekt eftersom det föregående är ogiltigt.
