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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници