For Each...Next-Anweisung

Microsoft® Visual Basic® Scripting Edition
For Each...Next-Anweisung

Beschreibung

Wiederholt eine Reihe von Anweisungen für alle Elemente eines Datenfeldes oder einer Auflistung.

Syntax

For Each Element In Gruppe
    [Anweisungen]
    [Exit For]
    [Anweisungen]
Next [Element]

Die Syntax der For Each...Next-Anweisung besteht aus folgenden Teilen:

Teil Beschreibung
Element Variable zum Durchlauf durch die Elemente der Auflistung oder des Datenfeldes. Bei Auflistungen sind für Element nur Variablen vom Typ Variant, allgemeine Variablen vom Typ Object oder spezielle Variablen für OLE-Automatisierungsobjekte zulässig. Bei Datenfeldern sind für Element nur Variablen vom Typ Variant zulässig.
Gruppe Name einer Objektauflistung oder eines Datenfeldes.
Anweisungen Eine oder mehrere Anweisungen, die für jedes Element in Gruppeausgeführt werden.

Anmerkungen

Der For Each-Block wird ausgeführt, wenn sich mindestens ein Element in Gruppe befindet. In diesem Fall führt das Programm alle Anweisungen in der Schleife für das erste Element in Gruppe aus. Die Schleife wird für alle Elemente in Gruppe wiederholt, bis sich keine Elemente mehr in Gruppe befinden. Dann verläßt das Programm die Schleife und setzt die Ausführung mit der Anweisung fort, die auf die Next-Anweisung folgt.
Exit For ist nur innerhalb einer For Each...Next- oder For...Next-Kontrollstuktur zulässig und stellt eine Alternative zum Verlassen der Struktur dar. Exit For kann an beliebiger Stelle und beliebig oft in der Schleife verwendet werden. Exit For wird oft in Zusammenhang mit der Auswertung einer Bedingung (zum Beispiel If...Then) eingesetzt und weist das Programm an, die Ausführung mit der ersten Anweisung im Anschluß an Next fortzusetzen.
Sie können For Each...Next-Schleifen verschachteln, indem Sie eine For Each...Next innerhalb einer anderen verwenden. Das Argument Element muß jedoch für alle Schleifen eindeutig sein.

Hinweis Das Argument Element in einer Next-Anweisung ist nicht zwingend notwendig. Die Ausführung wird mit einem Element genauso fortgesetzt wie ohne Element. Eine Next-Anweisung vor der zugehörigen For-Anweisung führt zu einem Fehler.

Teil	Beschreibung
Element	Variable zum Durchlauf durch die Elemente der Auflistung oder des Datenfeldes. Bei Auflistungen sind für Element nur Variablen vom Typ Variant, allgemeine Variablen vom Typ Object oder spezielle Variablen für OLE-Automatisierungsobjekte zulässig. Bei Datenfeldern sind für Element nur Variablen vom Typ Variant zulässig.
Gruppe	Name einer Objektauflistung oder eines Datenfeldes.
Anweisungen	Eine oder mehrere Anweisungen, die für jedes Element in Gruppeausgeführt werden.


Hinweis Das Argument Element in einer Next-Anweisung ist nicht zwingend notwendig. Die Ausführung wird mit einem Element genauso fortgesetzt wie ohne Element. Eine Next-Anweisung vor der zugehörigen For-Anweisung führt zu einem Fehler.