Herhaalt een groep instructies voor elk element in een matrix of collectie.
Syntaxis
For Each element In groep
[instructies]
[Exit For]
[instructies]
Next [element]
De instructie For...Each...Next heeft de volgende argumenten:
| Onderdeel | Beschrijving |
|---|---|
| element | Vereist. Variabele die de elementen van een collectie of matrix herhaalt. Voor collecties kan element alleen een Variant-variabele, een algemene objectvariabele of een specifieke objectvariabele zijn. Voor matrices kan element alleen een variabele Variant zijn. |
| Groep | Vereist. Naam van een objectcollectie of matrix (behalve een matrix van een door de gebruiker gedefinieerd type). |
| instructies | Optioneel. Een of meer instructies die worden uitgevoerd op elk element in groep. |
Notities
Het blok For...Each wordt uitgevoerd als zich ten minste een element in groep bevindt. Als de lus eenmaal is begonnen worden alle instructies in de lus uitgevoerd voor het eerste element in groep. Als er meer elementen in groep zijn, worden de instructies in de lus voor ieder element uitgevoerd. Wanneer er geen elementen meer in groep zijn, wordt de lus beδindigd en gaat de uitvoering verder met de instructie die volgt op de instructie Next.
Een willekeurig aantal instructies Exit For mogen overal binnen de lus worden geplaatst als een alternatieve manier om de lus te beδindigen. Exit For wordt vaak gebruikt nadat een bepaalde voorwaarde is geδvalueerd, bijvoorbeeld IfàThen, en draagt de besturing over aan de instructie die onmiddellijk volgt op Next.
U kunt lussen For...Each...Next nesten door een lus For...Each...Next binnen een andere te plaatsen. Elk lus-element moet echter uniek zijn.
Opmerking Als u element uit een instructie Next weglaat, gaat de uitvoering verder alsof element wel was opgenomen. Als er een instructie Next volgt v≤≤r de bijbehorende instructie For, treedt een fout op.
U kunt de instructie For...Each...Next niet gebruiken met een matrix van door de gebruiker gedefinieerde typen, omdat een Variant geen door de gebruiker gedefinieerd type kan bevatten.