IEnumeratorContract<T> 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
枚举集合中的 IListContract<T> 元素。
generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable
类型参数
- T
要枚举的对象的类型。
- 实现
注解
枚举器可用于读取集合中的数据,但不能用于修改集合。
最初,枚举器位于集合中的第一个元素之前。 在此位置,返回值为 GetCurrent 未定义。 因此,必须先调用枚举器,才能在 MoveNext 调用 GetCurrent之前将枚举器提升到集合的第一个元素。
GetCurrent 返回相同的对象,直到 MoveNext 调用为止。 MoveNext 将返回值 GetCurrent 设置为下一个元素。
如果 MoveNext 传递集合的末尾,则枚举器位于集合中的最后一个元素之后并 MoveNext 返回 false。 当枚举器处于此位置时,后续调用 MoveNext 也会返回 false。 如果返回false的最后一次调用MoveNext,则返回值GetCurrent为未定义。
只要集合保持不变,枚举器就保持有效。 如果对集合进行了更改(例如添加、修改或删除元素),则枚举器不可恢复地失效,并且其行为未定义。
方法
| 名称 | 说明 |
|---|---|
| Dispose() |
执行与释放、释放或重置非托管资源关联的应用程序定义任务。 (继承自 IDisposable) |
| GetCurrent() |
返回集合中枚举器当前位置的对象。 |
| MoveNext() |
将枚举器推进到集合的下一个元素。 |
| Reset() |
将枚举器设置为其初始位置,该位置位于集合中的第一个元素之前。 |