CKTIS / C#
Niegeneryczne IEnumerable i IEnumerator w System.Collections
Interfejs IEnumerable udostępnia enumerator, a IEnumerator śledzi pozycję w sekwencji. Jawna implementacja pozwala obsłużyć kontrakt niegeneryczny bez powielania logiki iteracji.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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 reprezentuje źródło elementów, a jego GetEnumerator() zwraca System.Collections.IEnumerator, który przechowuje pozycję w sekwencji. Enumerator zaczyna przed pierwszym elementem. Odczytuj Current tylko po tym, jak MoveNext() zwróci true. Gdy zwróci false, zakończ iterację. Reset() ma przywracać pozycję początkową, ale może zgłosić NotSupportedException, jak w iteratorach z yield. Aby zacząć od nowa, pobierz nowy enumerator.
IEnumerable<T> z System.Collections.Generic dziedziczy po niegenerycznym IEnumerable, więc klasa musi spełnić oba kontrakty. Udostępnij publiczną metodę zwracającą IEnumerator<T> i dodaj IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. To jawna implementacja, dostępna przez interfejs niegeneryczny, a nie zwykłe przeciążenie: C# nie pozwala przeciążać metod różniących się tylko typem zwracanym. Oba wywołania korzystają z tej samej logiki iteracji.
IEnumerator<T> dziedziczy po IEnumerator i IDisposable. Generyczne Current ma typ T, a niegeneryczne zwraca object. W przykładzie odczyt niegenerycznego Current opakowuje int w obiekt (boxing), a foreach (int ...) go rozpakowuje (unboxing). Iterator z yield dostarcza obie wersje Current. We własnym enumeratorze możesz zaimplementować niegeneryczne Current jawnie.
foreach wywołuje MoveNext() i odczytuje Current bez użycia Reset(). Zwalnia też enumerator, jeśli ten implementuje IDisposable, nawet przy wcześniejszym wyjściu z pętli. Jeśli iterujesz ręcznie przez IEnumerator, sprawdź w finally, czy enumerator implementuje IDisposable, i jeśli tak, wywołaj Dispose(): sam interfejs niegeneryczny nie wymaga tej metody.
Przykłady
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();
}Wynik
Generic: 2 Generic: 4 Non-generic: 2 Non-generic: 4
Obie zmienne wskazują ten sam obiekt. Druga pętla wywołuje jawną implementację przez `IEnumerable` i po raz drugi odczytuje wartości `2` i `4`.
Powiązane lekcje
- C# · Lekcja 38 · Średniozaawansowany · Wersja: 2
Źródła
- 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)