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
Източници
- 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)