База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Необобщени интерфейси IEnumerable и IEnumerator в System.Collections

IEnumerable предоставя енумератор, а IEnumerator следи позицията в поредицата. Явната реализация изпълнява необобщения договор, без да дублира логиката за обхождане.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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 представлява източник на елементи. Методът му GetEnumerator() връща System.Collections.IEnumerator, който следи позицията в поредицата. Енумераторът започва преди първия елемент. Чети Current само след като MoveNext() върне true, и спри обхождането, когато върне false. Reset() служи за връщане в началната позиция, но може да предизвика NotSupportedException, както при итераторите с yield. За да започнеш отначало, вземи нов енумератор.

IEnumerable<T> от System.Collections.Generic наследява необобщения IEnumerable, затова класът трябва да изпълни и двата договора. Предостави публичен метод, който връща IEnumerator<T>, и добави IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();. Тази явна реализация е достъпна през необобщения интерфейс. Това не е обикновено претоварване: C# не позволява претоварвания, които се различават само по връщания тип. И двете извиквания използват една и съща логика за обхождане.

IEnumerator<T> наследява IEnumerator и IDisposable. Обобщеното свойство Current е от тип T, а необобщеното връща object. В примера четенето на необобщеното Current опакова стойност от тип int в обект (boxing), а foreach (int ...) я разопакова (unboxing). Итераторът с yield предоставя и двете версии на Current. Ако пишеш собствен енумератор, можеш да реализираш явно необобщеното Current.

foreach извиква MoveNext() и чете Current, без да използва Reset(). Ако енумераторът реализира IDisposable, foreach извиква и Dispose(), дори при преждевременно излизане от цикъла. При ръчно обхождане чрез IEnumerator провери в блок finally дали енумераторът реализира IDisposable, и ако е така, извикай Dispose(): самият необобщен интерфейс не изисква този метод.

Примери

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();
}

Резултат

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

Двете променливи сочат към един и същ обект. Вторият цикъл извиква явната реализация през `IEnumerable` и прочита отново `2` и `4`.

Свързани уроци

  • C# · Урок 38 · Средно · Версия: 2

Източници