SortedList.IEnumerable.GetEnumerator 方法

定义

返回循环访问的IEnumerator一个 SortedList

 virtual System::Collections::IEnumerator ^ System.Collections.IEnumerable.GetEnumerator() = System::Collections::IEnumerable::GetEnumerator;
System.Collections.IEnumerator IEnumerable.GetEnumerator();
abstract member System.Collections.IEnumerable.GetEnumerator : unit -> System.Collections.IEnumerator
override this.System.Collections.IEnumerable.GetEnumerator : unit -> System.Collections.IEnumerator
Function GetEnumerator () As IEnumerator Implements IEnumerable.GetEnumerator

返回

的一个 IEnumeratorSortedList

实现

注解

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

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

最初,枚举器位于集合中的第一个元素之前。 Reset 还将枚举器带回此位置。 在此位置,调用 Current 将引发异常。 因此,在读取值MoveNext之前,必须调用Current枚举器将枚举器提升到集合的第一个元素。

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

如果 MoveNext 传递集合的末尾,则枚举器位于集合中的最后一个元素之后并 MoveNext 返回 false。 当枚举器处于此位置时,后续调用 MoveNext 也会返回 false。 如果返回MoveNext的最后一次调用false,则调用Current将引发异常。 若要再次设置为 Current 集合的第一个元素,可以调用 Reset 后跟 MoveNext

只要集合保持不变,枚举器就保持有效。 如果对集合进行了更改(例如添加、修改或删除元素),枚举器将不可恢复地失效,并且下次调用 MoveNextReset 时会引发 InvalidOperationException 异常。 如果集合在两Current者之间MoveNext进行了修改,Current则返回它设置为的元素,即使枚举器已失效。

枚举器不具有对集合的独占访问权限;因此,通过集合进行枚举本质上不是线程安全的过程。 即使集合同步,其他线程仍可以修改集合,这会导致枚举器引发异常。 若要保证枚举期间的线程安全性,可以在整个枚举期间锁定集合,也可以捕获由其他线程所做的更改导致的异常。

此方法是一个 O(1) 操作。

适用于

另请参阅