Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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