Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

Negenerička sučelja IEnumerable i IEnumerator u prostoru imena System.Collections

IEnumerable daje enumerator, a IEnumerator prati položaj u slijedu. Eksplicitna implementacija ispunjava negenerički ugovor bez dupliciranja logike prolaska kroz elemente.

Verzija: 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 izvor elemenata. Njegova metoda GetEnumerator() vraća System.Collections.IEnumerator koji prati položaj u slijedu. Enumerator počinje ispred prvog elementa. Čitaj Current samo nakon što MoveNext() vrati true i završi prolazak kad vrati false. Reset() služi za povratak na početni položaj, ali može izazvati iznimku NotSupportedException, kao kod iteratora s yield. Za novi prolazak dohvati novi enumerator.

IEnumerable<T> iz System.Collections.Generic nasljeđuje negenerički IEnumerable, pa klasa mora ispuniti oba ugovora. Izloži javnu metodu koja vraća IEnumerator<T> i dodaj IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Ta je eksplicitna implementacija dostupna putem negeneričkog sučelja. Nije riječ o običnom preopterećenju: C# ne dopušta preopterećenja koja se razlikuju samo po povratnom tipu. Oba poziva koriste istu logiku prolaska.

IEnumerator<T> nasljeđuje IEnumerator i IDisposable. Generički Current ima tip T, a negenerički Current vraća object. Pri čitanju negeneričkog Current u primjeru se int pakira u objekt (boxing), a foreach (int ...) ga raspakirava (unboxing). Iterator s yield pruža obje verzije svojstva Current. Ako pišeš vlastiti enumerator, negenerički Current možeš implementirati eksplicitno.

foreach poziva MoveNext() i čita Current bez upotrebe metode Reset(). Poziva i Dispose() ako enumerator implementira IDisposable, čak i pri ranijem izlasku iz petlje. Pri ručnom prolasku kroz IEnumerator u bloku finally provjeri implementira li enumerator IDisposable i, ako da, pozovi Dispose(): negeneričko sučelje ne zahtijeva tu metodu.

Primjeri

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

Obje varijable upućuju na isti objekt. Druga petlja poziva eksplicitnu implementaciju putem sučelja `IEnumerable` i ponovno čita `2` i `4`.

Povezane lekcije

  • C# · Lekcija 38 · Srednje · Verzija: 2

Izvori