CKTIS / C#
Негенеричният интерфейс IEnumerable
System.Collections.IEnumerable позволява обхождане на елементи, без типът им да се задава чрез генеричен параметър. Методът GetEnumerator() връща IEnumerator, а foreach чете елементите чрез този договор.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public interface IEnumerable
{
System.Collections.IEnumerator GetEnumerator();
}System.Collections.IEnumerable е негенеричен договор за обхождане на елементи. Той декларира един метод: GetEnumerator(), който връща System.Collections.IEnumerator. Не предоставя брой елементи или индексатор.
Разграничавайте последователността от нейния енумератор: IEnumerable предоставя енумератор, докато IEnumerator поддържа позицията на итерацията. MoveNext() преминава към следващия елемент и указва дали това е успешно; едва тогава може да се прочете Current от тип object. Четенето на Current преди първото успешно придвижване или след края на итерацията е невалидно. Не е задължително Reset() да се поддържа.
System.Collections.Generic.IEnumerable<T> задава типа на елементите и наследява негенеричния IEnumerable. Когато типът е известен, обикновено предпочитайте генеричната версия; негенеричната е полезна при взаимодействие с API, които изискват този договор. Изричният тип на променлива във foreach, например string, изисква валидно преобразуване на всеки елемент; несъвместим елемент може да причини InvalidCastException.
В примера масивът се достъпва чрез IEnumerable, затова value е от тип object, въпреки че елементите са низове. foreach се грижи за придвижването на енумератора. Самото използване на foreach обаче не доказва, че този интерфейс е реализиран: C# поддържа и подходящ шаблон GetEnumerator() с MoveNext() и Current.
Примери
using System;
using System.Collections;
internal static class Program
{
private static void Main()
{
IEnumerable values = new string[] { "Ada", "Lin" };
foreach (object value in values)
{
Console.WriteLine(value);
}
}
}Резултат
Ada Lin
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.