IEnumerator<T> 接口

定义

支持对泛型集合进行简单迭代。

public interface IEnumerator<out T> : IDisposable, System.Collections.IEnumerator
public interface IEnumerator<T> : IDisposable, System.Collections.IEnumerator

类型参数

T

要枚举的对象的类型。

这是协变类型参数。 即,可以使用指定的类型,也可以使用派生程度较高的任何类型。 有关协变和逆变的详细信息,请参阅泛型中的协变和逆变
派生
实现

示例

以下示例演示自定义对象的集合类的 IEnumerator<T> 接口的实现。 自定义对象是类型 Box的实例,集合类 BoxCollection。 此代码示例是为 ICollection<T> 接口提供的较大示例的一部分。


// Defines the enumerator for the Boxes collection.
// (Some prefer this class nested in the collection class.)
public class BoxEnumerator : IEnumerator<Box>
{
    private BoxCollection _collection;
    private int curIndex;
    private Box curBox;

    public BoxEnumerator(BoxCollection collection)
    {
        _collection = collection;
        curIndex = -1;
        curBox = default(Box);
    }

    public bool MoveNext()
    {
        //Avoids going beyond the end of the collection.
        if (++curIndex >= _collection.Count)
        {
            return false;
        }
        else
        {
            // Set current box to next item in collection.
            curBox = _collection[curIndex];
        }
        return true;
    }

    public void Reset() { curIndex = -1; }

    void IDisposable.Dispose() { }

    public Box Current
    {
        get { return curBox; }
    }

    object IEnumerator.Current
    {
        get { return Current; }
    }
}

注解

IEnumerator<T> 是所有泛型枚举器的基本接口。

C# 语言的 foreach 语句(C++中的for each,在 Visual Basic 中 For Each)隐藏枚举器的复杂性。 因此,建议使用 foreach,而不是直接操作枚举器。

枚举器可用于读取集合中的数据,但不能用于修改基础集合。

最初,枚举器位于集合中的第一个元素之前。 在此位置,Current 未定义。 因此,在读取 Current值之前,必须调用 MoveNext 将枚举器提升到集合的第一个元素。

Current 返回相同的对象,直到调用 MoveNextMoveNextCurrent 设置为下一个元素。

如果 MoveNext 传递集合的末尾,则枚举器位于集合中的最后一个元素之后,MoveNext 返回 false。 当枚举器处于此位置时,对 MoveNext 的后续调用也会返回 false。 如果最后一次调用 MoveNext 返回 false,则 Current 未定义。 不能再次将 Current 设置为集合的第一个元素;必须改为创建新的枚举器实例。

为 COM 互操作性提供了 Reset 方法。 它不一定需要实现;相反,实现者只需引发 NotSupportedException。 但是,如果选择执行此操作,则应确保没有调用方依赖于 Reset 功能。

如果对集合进行了更改(例如添加、修改或删除元素),则枚举器的行为是未定义的。

枚举器不具有对集合的独占访问权限;因此,通过集合进行枚举本质上不是线程安全的过程。 若要保证枚举期间的线程安全性,可以在整个枚举期间锁定集合。 若要允许多个线程访问集合进行读取和写入,必须实现自己的同步。

System.Collections.Generic 命名空间中集合的默认实现不会同步。

实施者说明

实现此接口需要实现非泛型 IEnumerator 接口。 MoveNext()Reset() 方法不依赖于 T,仅显示在非泛型接口上。 Current 属性同时显示在两个接口上,并且具有不同的返回类型。 将非泛型 Current 属性实现为显式接口实现。 这允许非泛型接口的任何使用者使用泛型接口。

此外,IEnumerator<T> 实现 IDisposable,这要求你实现 Dispose() 方法。 这使你可以在使用其他资源时关闭数据库连接或释放文件句柄或类似操作。 如果没有要释放的其他资源,请提供空的 Dispose() 实现。

属性

Current

获取集合中枚举器当前位置的元素。

方法

Dispose()

执行与释放、释放或重置非托管资源关联的应用程序定义任务。

(继承自 IDisposable)
MoveNext()

将枚举器推进到集合的下一个元素。

(继承自 IEnumerator)
Reset()

将枚举器设置为其初始位置,该位置位于集合中的第一个元素之前。

(继承自 IEnumerator)

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅