Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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