CKTIS / C#
De niet-generieke IEnumerable-interface
System.Collections.IEnumerable maakt iteratie over elementen mogelijk zonder het elementtype via een generieke parameter op te geven. De methode GetEnumerator() retourneert IEnumerator, en foreach leest elementen via dit contract.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public interface IEnumerable
{
System.Collections.IEnumerator GetEnumerator();
}System.Collections.IEnumerable is een niet-generiek contract voor het doorlopen van elementen. Het declareert één methode: GetEnumerator(), die System.Collections.IEnumerator retourneert. Het biedt geen aantal elementen en geen indexer.
Maak onderscheid tussen de reeks en de enumerator: IEnumerable levert een enumerator, terwijl IEnumerator de iteratiepositie bijhoudt. MoveNext() gaat naar het volgende element en geeft aan of dat is gelukt; pas daarna kun je Current van het type object lezen. Current lezen vóór de eerste geslaagde verplaatsing of nadat de iteratie is beëindigd, is niet geldig. Reset() hoeft niet te worden ondersteund.
System.Collections.Generic.IEnumerable<T> legt het elementtype vast en erft van de niet-generieke IEnumerable. Als het type bekend is, heeft de generieke versie meestal de voorkeur; de niet-generieke versie is nuttig bij samenwerking met API’s die dit contract vereisen. Een expliciet type voor de variabele in foreach, zoals string, vereist een geldige conversie voor elk element; een incompatibel element kan InvalidCastException veroorzaken.
In het voorbeeld wordt de array via IEnumerable benaderd, dus heeft value het type object, hoewel de elementen tekenreeksen zijn. foreach verzorgt het verplaatsen van de enumerator. Het gebruik van foreach bewijst op zichzelf echter niet dat deze interface is geïmplementeerd: C# ondersteunt ook een passend GetEnumerator()-patroon met MoveNext() en Current.
Voorbeelden
using System;
using System.Collections;
internal static class Program
{
private static void Main()
{
IEnumerable values = new string[] { "Ada", "Lin" };
foreach (object value in values)
{
Console.WriteLine(value);
}
}
}Resultaat
Ada Lin
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.