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
- 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)