Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

Negenerična vmesnika IEnumerable in IEnumerator v System.Collections

IEnumerable zagotovi enumerator, IEnumerator pa spremlja položaj v zaporedju. Eksplicitna implementacija izpolni negenerično pogodbo brez podvajanja logike iteracije.

Različica: C# 12 and .NET 8; later runtimes may add compatible features

Sintaksa

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 predstavlja vir elementov. Njegova metoda GetEnumerator() vrne System.Collections.IEnumerator, ki spremlja položaj v zaporedju. Enumerator je sprva pred prvim elementom. Preberi Current samo po tem, ko MoveNext() vrne true, in končaj iteracijo, ko vrne false. Reset() je namenjen vrnitvi na začetni položaj, vendar lahko sproži izjemo NotSupportedException, kot se zgodi pri iteratorjih z yield. Za ponovni začetek pridobi nov enumerator.

IEnumerable<T> iz System.Collections.Generic podeduje negenerični IEnumerable, zato mora razred izpolniti obe pogodbi. Izpostavi javno metodo, ki vrne IEnumerator<T>, in dodaj IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Ta eksplicitna implementacija je dostopna prek negeneričnega vmesnika. Ne gre za običajno preobremenitev: C# ne dovoljuje preobremenitev, ki se razlikujejo samo po vrnjenem tipu. Oba klica uporabljata isto logiko iteracije.

IEnumerator<T> podeduje IEnumerator in IDisposable. Generični Current je tipa T, negenerični Current pa vrne object. V primeru se pri branju negeneričnega Current vrednost int zapakira v objekt (boxing), foreach (int ...) pa jo odpakira (unboxing). Iterator z yield zagotovi obe različici Current. Če pišeš svoj enumerator, lahko negenerični Current implementiraš eksplicitno.

foreach kliče MoveNext() in bere Current brez uporabe Reset(). Če enumerator implementira IDisposable, pokliče tudi Dispose(), celo ob predčasnem izhodu iz zanke. Pri ročni iteraciji prek IEnumerator v bloku finally preveri, ali enumerator implementira IDisposable, in v tem primeru pokliči Dispose(): negenerični vmesnik te metode ne zahteva.

Primeri

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();
}

Rezultat

Generic: 2
Generic: 4
Non-generic: 2
Non-generic: 4

Obe spremenljivki se sklicujeta na isti objekt. Druga zanka prek `IEnumerable` pokliče eksplicitno implementacijo in znova prebere `2` in `4`.

Povezane lekcije

  • C# · Lekcija 38 · Srednja · Različica: 2

Viri