Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Negenerické rozhrania IEnumerable a IEnumerator v System.Collections

IEnumerable poskytuje enumerátor a IEnumerator udržiava pozíciu v postupnosti. Explicitná implementácia splní negenerický kontrakt bez zdvojovania logiky prechádzania.

Verzia: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

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 predstavuje zdroj prvkov. Jeho metóda GetEnumerator() vracia System.Collections.IEnumerator, ktorý udržiava pozíciu v postupnosti. Enumerátor začína pred prvým prvkom. Čítaj Current len po tom, čo MoveNext() vráti true, a ukonči prechádzanie, keď vráti false. Reset() má obnoviť počiatočnú pozíciu, ale môže vyvolať NotSupportedException, ako pri iterátoroch s yield. Ak chceš začať odznova, získaj nový enumerátor.

IEnumerable<T> z System.Collections.Generic dedí z negenerického IEnumerable, takže trieda musí splniť oba kontrakty. Sprístupni verejnú metódu, ktorá vracia IEnumerator<T>, a pridaj IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Táto explicitná implementácia je prístupná cez negenerické rozhranie. Nejde o bežné preťaženie: C# nepovoľuje preťažiť metódy, ktoré sa líšia iba návratovým typom. Obe volania používajú rovnakú logiku prechádzania.

IEnumerator<T> dedí z IEnumerator a IDisposable. Generické Current má typ T, kým negenerické Current vracia object. Pri čítaní negenerického Current sa v príklade int zabalí do objektu (boxing) a foreach (int ...) ho rozbalí (unboxing). Iterátor s yield poskytuje obe verzie Current. Ak píšeš vlastný enumerátor, môžeš negenerické Current implementovať explicitne.

foreach volá MoveNext() a číta Current bez použitia Reset(). Ak enumerátor implementuje IDisposable, volá aj Dispose(), a to aj pri predčasnom ukončení cyklu. Pri ručnom prechádzaní cez IEnumerator v bloku finally over, či enumerátor implementuje IDisposable. Ak áno, zavolaj Dispose(): samotné negenerické rozhranie túto metódu nevyžaduje.

Prí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ýsledok

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

Obe premenné odkazujú na ten istý objekt. Druhý cyklus volá explicitnú implementáciu cez `IEnumerable` a znova prečíta `2` a `4`.

Súvisiace lekcie

  • C# · Lekcia 38 · Stredne pokročilá · Verzia: 2

Zdroje