定义

返回一个循环访问集合的枚举器。

C#
public System.Collections.IEnumerator GetEnumerator ();

返回

IEnumerator

用于循环访问集合的枚举数。

示例

下面的示例演示如何用于 GetEnumerator 检索对象的所有元素 Collection 。

VB
Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
    thisCustomer = custEnum.Current()
    ' Insert code to process this element of the collection.
End While

GetEnumerator 构造并返回一个枚举器对象,该对象实现 IEnumerator 命名空间的 System.Collections 接口。 枚举器对象公开Current属性和MoveNextReset方法和方法。 有关详细信息,请参阅 For Each...Next 语句。

注解

For each...Next 语句调用GetEnumerator以获取枚举器对象,以支持对集合的元素进行迭代。 通常,使用 For Each...Next 循环遍历集合或数组,无需显式调用 GetEnumerator 。

如果需要比 ...Next 语句提供的迭代For Each更紧密的控制,可以使用GetEnumerator该方法执行自定义遍历。 下面是可能需要执行此操作的一些情况。

  • 你可能想要返回到集合的开头,并在迭代完成之前重新开始迭代。

  • 出于各种原因,你可能想要跳过一个或多个元素。

  • 可能需要更改遍历中间集合的元素。 在这种情况下,必须获取新的枚举器对象,因为上一个枚举器对象无效。

适用于

产品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7 Preview 4
.NET Framework 1.1, 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