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

CKTIS / C#

IEnumerator — негенеричният интерфейс за изброяване

System.Collections.IEnumerator описва курсор за последователно четене на елементи. Той предоставя MoveNext(), Current от тип object и Reset(); не е колекция и не гарантира поддръжка на IDisposable.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

public interface IEnumerator
{
    object Current { get; }
    bool MoveNext();
    void Reset();
}

System.Collections.IEnumerator описва състоянието на едно преминаване през колекция. За разлика от него System.Collections.IEnumerable предоставя GetEnumerator(), който връща такъв курсор. В обичайния код предпочитайте foreach, който скрива ръчното управление на енумератора. Интерфейсът е наличен в .NET 10 и не изисква езикови функции в предварителна версия.

Първоначално курсорът е преди първия елемент. Извикайте MoveNext() и четете Current само ако резултатът е true. Резултат false означава край; следващите извиквания също връщат false, освен ако енумераторът не бъде нулиран. Current не е дефиниран преди първото успешно преместване и след приключване — не приемайте конкретна стойност или изключение.

Current е свойство само за четене от тип object: получаването на конкретен тип може да изисква преобразуване, а стойностите от стойностни типове се boxing-ват. Генеричният тип System.Collections.Generic.IEnumerator<T> предоставя Current от тип T и наследява както IEnumerator, така и IDisposable. Негенеричният IEnumerator сам по себе си не наследява IDisposable; при ръчна итерация освободете енумератора, ако обектът му реализира този интерфейс.

Reset() трябва да възстанови позицията преди първия елемент, но може да хвърли NotSupportedException; използва се главно за взаимодействие с COM. За да повторите преминаването, обикновено вземете нов енумератор. Не приемайте, че промените в колекцията по време на итерация се поддържат: те могат да направят енумератора невалиден. Интерфейсът не осигурява безопасност при работа с нишки и не предоставя операции за промяна на колекцията.

Примери

using System;
using System.Collections;

internal static class Program
{
    private static void Main()
    {
        IEnumerable values = new string[] { "Ada", "Lin" };
        IEnumerator cursor = values.GetEnumerator();

        try
        {
            while (cursor.MoveNext())
            {
                string value = (string)cursor.Current;
                Console.WriteLine(value);
            }
        }
        finally
        {
            (cursor as IDisposable)?.Dispose();
        }
    }
}

Резултат

Ada
Lin

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

Източници