IEnumerator<T> 接口

定义

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

generic <typename T>
public interface class IEnumerator : IDisposable, System::Collections::IEnumerator
public interface IEnumerator<out T> : IDisposable, System.Collections.IEnumerator
public interface IEnumerator<T> : IDisposable, System.Collections.IEnumerator
type IEnumerator<'T> = interface
    interface IEnumerator
    interface IDisposable
type IEnumerator<'T> = interface
    interface IDisposable
    interface IEnumerator
Public Interface IEnumerator(Of Out T)
Implements IDisposable, IEnumerator
Public Interface IEnumerator(Of T)
Implements IDisposable, 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; }
    }
}
' Defines the enumerator for the Boxes collection.
' (Some prefer this class nested in the collection class.)
Public Class BoxEnumerator
    Implements IEnumerator(Of Box)
    Private _collection As BoxCollection
    Private curIndex As Integer
    Private curBox As Box


    Public Sub New(ByVal collection As BoxCollection)
        MyBase.New()
        _collection = collection
        curIndex = -1
        curBox = Nothing

    End Sub

    Private Property Box As Box
    Public Function MoveNext() As Boolean _
        Implements IEnumerator(Of Box).MoveNext
        curIndex = curIndex + 1
        If curIndex = _collection.Count Then
            ' Avoids going beyond the end of the collection.
            Return False
        Else
            'Set current box to next item in collection.
            curBox = _collection(curIndex)
        End If
        Return True
    End Function

    Public Sub Reset() _
        Implements IEnumerator(Of Box).Reset
        curIndex = -1
    End Sub

    Public Sub Dispose() _
        Implements IEnumerator(Of Box).Dispose

    End Sub

    Public ReadOnly Property Current() As Box _
        Implements IEnumerator(Of Box).Current

        Get
            If curBox Is Nothing Then
                Throw New InvalidOperationException()
            End If

            Return curBox
        End Get
    End Property

    Private ReadOnly Property Current1() As Object _
        Implements IEnumerator.Current

        Get
            Return Me.Current
        End Get
    End Property
End Class

' Defines two boxes as equal if they have the same dimensions.
Public Class BoxSameDimensions
    Inherits EqualityComparer(Of Box)

    Public Overrides Function Equals(ByVal b1 As Box, ByVal b2 As Box) As Boolean
        If b1.Height = b2.Height And b1.Length = b2.Length And b1.Width = b2.Width Then
            Return True
        Else
            Return False
        End If
    End Function

    Public Overrides Function GetHashCode(ByVal bx As Box) As Integer
        Dim hCode As Integer = bx.Height ^ bx.Length ^ bx.Width
        Return hCode.GetHashCode()
    End Function
End Class

注解

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)

适用于

另请参阅