CKTIS / C#
Die nicht generische IEnumerable-Schnittstelle
System.Collections.IEnumerable ermöglicht die Iteration über Elemente, ohne ihren Typ durch einen generischen Typparameter festzulegen. Die Methode GetEnumerator() gibt IEnumerator zurück, und foreach liest Elemente über diesen Vertrag aus.
Version: .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 ist ein nicht generischer Vertrag für die Iteration über Elemente. Er deklariert eine Methode: GetEnumerator(), die System.Collections.IEnumerator zurückgibt. Er stellt weder eine Elementanzahl noch einen Indexer bereit.
Unterscheide die Sequenz von ihrem Enumerator: IEnumerable stellt einen Enumerator bereit, während IEnumerator die Iterationsposition verwaltet. MoveNext() rückt zum nächsten Element vor und meldet, ob dies erfolgreich war; erst dann kann Current vom Typ object gelesen werden. Current vor dem ersten erfolgreichen Vorrücken oder nach dem Ende der Iteration zu lesen, ist nicht zulässig. Reset() muss nicht unterstützt werden.
System.Collections.Generic.IEnumerable<T> legt den Elementtyp fest und erbt vom nicht generischen IEnumerable. Wenn der Typ bekannt ist, solltest du im Allgemeinen die generische Variante bevorzugen; die nicht generische Variante ist nützlich, wenn du mit APIs zusammenarbeitest, die diesen Vertrag voraussetzen. Ein expliziter Variablentyp in foreach, etwa string, erfordert eine gültige Konvertierung jedes Elements; ein inkompatibles Element kann InvalidCastException auslösen.
Im Beispiel wird über IEnumerable auf das Array zugegriffen, daher hat value den Typ object, obwohl die Elemente Zeichenfolgen sind. foreach übernimmt das Vorrücken des Enumerators. Die Verwendung von foreach allein beweist jedoch nicht, dass diese Schnittstelle implementiert ist: C# unterstützt auch ein geeignetes GetEnumerator()-Muster mit MoveNext() und Current.
Beispiele
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);
}
}
}Ergebnis
Ada Lin
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.