ArrayList.GetEnumerator Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Collections

Zestawy:: mscorlib.dll, System.Collections.NonGeneric.dll

Zestaw:: System.Runtime.dll

Zestaw:: System.Collections.NonGeneric.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca moduł wyliczający, który iteruje przez element ArrayList.

Przeciążenia

GetEnumerator()	Zwraca moduł wyliczający dla całego ArrayListelementu .
GetEnumerator(Int32, Int32)	Zwraca moduł wyliczający dla zakresu elementów w obiekcie ArrayList.

GetEnumerator()

Zwraca moduł wyliczający dla całego ArrayListelementu .

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

Zwraca

IEnumerator

Element IEnumerator dla całego ArrayListelementu .

Implementuje

GetEnumerator()

Przykłady

Poniższy przykład pobiera moduł wyliczający dla ArrayListelementu i moduł wyliczający dla zakresu elementów w obiekcie 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
'

Uwagi

Instrukcja foreach języka C# (for each w Visual Basic) ukrywa złożoność modułów wyliczania. Dlatego użycie foreach jest zalecane zamiast bezpośredniego manipulowania modułem wyliczającym.

Moduły wyliczające mogą służyć do odczytu danych w kolekcji, ale nie można za ich pomocą modyfikować kolekcji źródłowej.

Początkowo moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji. Reset powoduje również powrót modułu wyliczającego do tej pozycji. Na tym stanowisku Current jest niezdefiniowany. W związku z tym należy wywołać metodę MoveNext , aby przejść do pierwszego elementu kolekcji przed odczytaniem wartości Current.

Current Metoda zwraca ten sam obiekt do momentu wywołania metody MoveNext lub Reset . MoveNext ustawia Current element na następny.

Jeśli MoveNext przejdzie koniec kolekcji, moduł wyliczający zostanie umieszczony po ostatnim elemecie w kolekcji i MoveNext zwróci wartość false. Gdy moduł wyliczający znajduje się na tym stanowisku, kolejne wywołania , aby MoveNext również zwrócić falsewartość . Jeśli ostatnie wywołanie zwracane MoveNext false, Current jest niezdefiniowane. Aby ponownie ustawić Current element na pierwszy element kolekcji, możesz wywołać Reset metodę , a następnie .MoveNext

Moduł wyliczający zachowuje ważność tak długo, jak długo kolekcja pozostaje niezmieniona. Jeśli w kolekcji zostaną wprowadzone zmiany, takie jak dodanie, zmodyfikowanie czy usunięcie elementów, moduł wyliczający jest nieodwracalnie unieważniany, a jego zachowanie staje się niezdefiniowane.

Moduł wyliczający nie ma wyłącznego dostępu do kolekcji, w związku z tym wyliczanie w kolekcji nie jest wewnętrznie procedurą odporną na wielowątkowość. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, można zablokować kolekcję podczas całego procesu wyliczania. Aby zezwolić wielu wątkom na dostęp do kolekcji w celu odczytu i zapisu danych, należy zaimplementować własny mechanizm synchronizacji.

Ta metoda jest operacją O(1) .

Zobacz też

IEnumerator

Dotyczy

GetEnumerator(Int32, Int32)

Zwraca moduł wyliczający dla zakresu elementów w obiekcie 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

Parametry

index: Int32

Zerowy indeks ArrayList początkowy sekcji, do którego powinien się odwoływać moduł wyliczający.

count: Int32

Liczba elementów w ArrayList sekcji, do których powinien odnosić się moduł wyliczający.

Zwraca

IEnumerator

Element IEnumerator dla określonego zakresu elementów w obiekcie ArrayList.

Wyjątki

ArgumentOutOfRangeException

Parametr index ma wartość niższą niż zero.

-lub- Parametr count ma wartość niższą niż zero.

ArgumentException

index i count nie należy określać prawidłowego zakresu w obiekcie ArrayList.