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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.