CKTIS / C#
Negenerická rozhraní IEnumerable a IEnumerator v System.Collections
IEnumerable poskytuje enumerátor a IEnumerator udržuje pozici v posloupnosti. Explicitní implementace splní negenerický kontrakt bez zdvojování logiky průchodu.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
using System.Collections;
using System.Collections.Generic;
sealed class Sequence<T> : IEnumerable<T>
{
public IEnumerator<T> GetEnumerator()
{
yield break;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}System.Collections.IEnumerable představuje zdroj prvků. Jeho metoda GetEnumerator() vrací System.Collections.IEnumerator, který udržuje pozici v posloupnosti. Enumerátor začíná před prvním prvkem. Čti Current jen poté, co MoveNext() vrátí true, a ukonči průchod, jakmile vrátí false. Reset() má obnovit počáteční pozici, může ale vyvolat NotSupportedException, jako u iterátorů s yield. Chceš-li začít znovu, získej nový enumerátor.
IEnumerable<T> z System.Collections.Generic dědí z negenerického IEnumerable, takže třída musí splnit oba kontrakty. Zpřístupni veřejnou metodu vracející IEnumerator<T> a přidej IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Tato explicitní implementace je přístupná přes negenerické rozhraní. Nejde o běžné přetížení: C# nepovoluje přetížení metod jen podle návratového typu. Obě volání používají stejnou logiku průchodu.
IEnumerator<T> dědí z IEnumerator a IDisposable. Generické Current má typ T, zatímco negenerické Current vrací object. V příkladu se při čtení negenerického Current zabalí int do objektu (boxing) a foreach (int ...) ho zase rozbalí (unboxing). Iterátor s yield zajišťuje obě verze Current. Píšeš-li vlastní enumerátor, můžeš negenerické Current implementovat explicitně.
foreach volá MoveNext() a čte Current, aniž by používal Reset(). Pokud enumerátor implementuje IDisposable, volá také Dispose(), a to i při předčasném ukončení smyčky. Při ručním průchodu přes IEnumerator ověř v bloku finally, zda enumerátor implementuje IDisposable, a pokud ano, zavolej Dispose(): samotné negenerické rozhraní tuto metodu nevyžaduje.
Příklady
using System;
using System.Collections;
using System.Collections.Generic;
IEnumerable<int> typed = new EvenPair();
IEnumerable untyped = typed;
foreach (int value in typed)
Console.WriteLine(FormattableString.Invariant($"Generic: {value}"));
foreach (int value in untyped)
Console.WriteLine(FormattableString.Invariant($"Non-generic: {value}"));
sealed class EvenPair : IEnumerable<int>
{
public IEnumerator<int> GetEnumerator()
{
yield return 2;
yield return 4;
}
IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
}Výsledek
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Obě proměnné odkazují na stejný objekt. Druhá smyčka zavolá explicitní implementaci přes `IEnumerable` a znovu přečte `2` a `4`.
Související lekce
- C# · Lekce 38 · Středně pokročilá · Verze: 2
Zdroje
- IEnumerable Interface (System.Collections)
- IEnumerator Interface (System.Collections)
- IEnumerable<T> Interface (System.Collections.Generic)
- IEnumerator<T> Interface (System.Collections.Generic)
- Explicit Interface Implementation (C# Programming Guide)
- Iterate through collections
- Statements — C# language specification
- Basic concepts — C# language specification
- Boxing and Unboxing (C# Programming Guide)