ArrayList.GetEnumerator 方法

参考

定义

命名空间:: System.Collections

程序集:: mscorlib.dll, System.Collections.NonGeneric.dll

程序集:: System.Runtime.dll

程序集:: System.Collections.NonGeneric.dll

程序集:: System.Runtime.Extensions.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回循环访问 ArrayList 的枚举数。

重载

GetEnumerator()	返回用于整个 ArrayList 的枚举数。
GetEnumerator(Int32, Int32)	返回 ArrayList 中元素范围的枚举器。

GetEnumerator()

Source:: ArrayList.cs

Source:: ArrayList.cs

Source:: ArrayList.cs

返回用于整个 ArrayList 的枚举数。

public:
 virtual System::Collections::IEnumerator ^ GetEnumerator();

public virtual System.Collections.IEnumerator GetEnumerator ();

abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Overridable Function GetEnumerator () As IEnumerator

IEnumerator

用于整个 ArrayList 的 IEnumerator。

实现

GetEnumerator()

示例

以下示例获取的枚举器 ArrayList，以及中 ArrayList元素范围的枚举器。

using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        ArrayList colors = new ArrayList();
        colors.Add("red");
        colors.Add("blue");
        colors.Add("green");
        colors.Add("yellow");
        colors.Add("beige");
        colors.Add("brown");
        colors.Add("magenta");
        colors.Add("purple");

        IEnumerator e = colors.GetEnumerator();
        while (e.MoveNext())
        {
            Object obj = e.Current;
            Console.WriteLine(obj);
        }

        Console.WriteLine();

        IEnumerator e2 = colors.GetEnumerator(2, 4);
        while (e2.MoveNext())
        {
            Object obj = e2.Current;
            Console.WriteLine(obj);
        }
    }
}

/* This code example produces
   the following ouput:
    red
    blue
    green
    yellow
    beige
    brown
    magenta
    purple

    green
    yellow
    beige
    brown
 */

Imports System.Collections

Class Program
    Private Shared Sub Main(ByVal args As String())
        Dim colors As New ArrayList()
        colors.Add("red")
        colors.Add("blue")
        colors.Add("green")
        colors.Add("yellow")
        colors.Add("beige")
        colors.Add("brown")
        colors.Add("magenta")
        colors.Add("purple")
        
        Dim e As IEnumerator = colors.GetEnumerator()
        While e.MoveNext()
            Dim obj As [Object] = e.Current
            Console.WriteLine(obj)
        End While
        
        Console.WriteLine()
        
        Dim e2 As IEnumerator = colors.GetEnumerator(2, 4)
        While e2.MoveNext()
            Dim obj As [Object] = e2.Current
            Console.WriteLine(obj)
        End While
    End Sub
End Class

' This code example produces
' the following ouput:
' red
' blue
' green
' yellow
' beige
' brown
' magenta
' purple
'
' green
' yellow
' beige
' brown
'

注解

C# 语言的 foreach 语句（在 Visual Basic 中为 for each）隐藏了枚举数的复杂性。因此，建议使用 foreach，而不是直接操作枚举数。

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

最初，枚举数定位在集合中第一个元素的前面。 Reset 也会将枚举器放回此位置。在此位置上，未定义 Current。因此，在读取 MoveNext 的值之前，必须调用 Current 将枚举器向前移动到集合的第一个元素。

在调用 Current 或 MoveNext 之前，Reset 返回同一对象。 MoveNext 将 Current 设置为下一个元素。

如果 MoveNext 传递集合的末尾，则枚举器位于集合中的最后一个元素之后，并 MoveNext 返回 false。当枚举器位于此位置时，对 MoveNext 的后续调用也会返回 false。如果最后一次MoveNext调用返回，falseCurrent则为未定义。若要再次将 Current 设置为集合的第一个元素，可以调用 Reset 并接着调用 MoveNext。

只要集合保持不变，枚举器就仍有效。如果对集合进行更改（如添加、修改或删除元素），则枚举数将失效且不可恢复，而且其行为是不确定的。

枚举数没有对集合的独占访问权；因此，从头到尾对一个集合进行枚举在本质上不是一个线程安全的过程。若要确保枚举过程中的线程安全性，可以在整个枚举过程中锁定集合。若要允许多个线程访问集合以进行读写操作，则必须实现自己的同步。

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

另请参阅

IEnumerator

适用于

GetEnumerator(Int32, Int32)

Source:: ArrayList.cs

Source:: ArrayList.cs

Source:: ArrayList.cs

返回 ArrayList 中元素范围的枚举器。

public:
 virtual System::Collections::IEnumerator ^ GetEnumerator(int index, int count);

public virtual System.Collections.IEnumerator GetEnumerator (int index, int count);

abstract member GetEnumerator : int * int -> System.Collections.IEnumerator
override this.GetEnumerator : int * int -> System.Collections.IEnumerator

Public Overridable Function GetEnumerator (index As Integer, count As Integer) As IEnumerator

参数

index: Int32

枚举器应引用的 ArrayList 部分从零开始的起始索引。

count: Int32

枚举器应引用的 ArrayList 部分中的元素数。

IEnumerator

ArrayList 中指定的元素范围的 IEnumerator。

例外

ArgumentOutOfRangeException

index 小于零。

或

count 小于零。

ArgumentException

index 和 count 未在 ArrayList 中指定有效范围。

示例

以下示例获取的枚举器 ArrayList，以及中 ArrayList元素范围的枚举器。

using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        ArrayList colors = new ArrayList();
        colors.Add("red");
        colors.Add("blue");
        colors.Add("green");
        colors.Add("yellow");
        colors.Add("beige");
        colors.Add("brown");
        colors.Add("magenta");
        colors.Add("purple");

        IEnumerator e = colors.GetEnumerator();
        while (e.MoveNext())
        {
            Object obj = e.Current;
            Console.WriteLine(obj);
        }

        Console.WriteLine();

        IEnumerator e2 = colors.GetEnumerator(2, 4);
        while (e2.MoveNext())
        {
            Object obj = e2.Current;
            Console.WriteLine(obj);
        }
    }
}

/* This code example produces
   the following ouput:
    red
    blue
    green
    yellow
    beige
    brown
    magenta
    purple

    green
    yellow
    beige
    brown
 */

Imports System.Collections

Class Program
    Private Shared Sub Main(ByVal args As String())
        Dim colors As New ArrayList()
        colors.Add("red")
        colors.Add("blue")
        colors.Add("green")
        colors.Add("yellow")
        colors.Add("beige")
        colors.Add("brown")
        colors.Add("magenta")
        colors.Add("purple")
        
        Dim e As IEnumerator = colors.GetEnumerator()
        While e.MoveNext()
            Dim obj As [Object] = e.Current
            Console.WriteLine(obj)
        End While
        
        Console.WriteLine()
        
        Dim e2 As IEnumerator = colors.GetEnumerator(2, 4)
        While e2.MoveNext()
            Dim obj As [Object] = e2.Current
            Console.WriteLine(obj)
        End While
    End Sub
End Class

' This code example produces
' the following ouput:
' red
' blue
' green
' yellow
' beige
' brown
' magenta
' purple
'
' green
' yellow
' beige
' brown
'

注解

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

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

在调用 Current 或 MoveNext 之前，Reset 返回同一对象。 MoveNext 将 Current 设置为下一个元素。

只要集合保持不变，枚举器就仍有效。如果对集合进行更改（如添加、修改或删除元素），则枚举数将失效且不可恢复，而且其行为是不确定的。

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

另请参阅

IEnumerator

适用于

通过

ArrayList.GetEnumerator 方法

定义

重载

GetEnumerator()

返回

实现

示例

注解

另请参阅

适用于

GetEnumerator(Int32, Int32)

参数

返回

例外

示例

注解

另请参阅

适用于

其他资源