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