IEnumerator.MoveNext Metódus

Definíció

Névtér:

System.Collections

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

IEnumerator.cs

Az enumerátor tovább lép a gyűjtemény következő elemére.

public:
 bool MoveNext();

public bool MoveNext();

abstract member MoveNext : unit -> bool

Public Function MoveNext () As Boolean

Válaszok

Boolean

true ha az enumerátor sikeresen továbbhaladt a következő elemre; false ha az enumerátor teljesítette a gyűjtemény végét.

Kivételek

InvalidOperationException

A gyűjtemény az enumerátor létrehozása után módosult.

Példák

Az alábbi kódpéldában az egyéni gyűjtemény felületeinek IEnumerator implementálása látható. Ebben a példában a MoveNext nem explicit módon van meghívva, de a foreach (for each Visual Basic) használatának támogatására van implementálva. Ez a kódpéldát a felület egy nagyobb példájának IEnumerator része.

// When you implement IEnumerable, you must also implement IEnumerator.
public class PeopleEnum : IEnumerator
{
    public Person[] _people;

    // Enumerators are positioned before the first element
    // until the first MoveNext() call.
    int position = -1;

    public PeopleEnum(Person[] list)
    {
        _people = list;
    }

    public bool MoveNext()
    {
        position++;
        return (position < _people.Length);
    }

    public void Reset()
    {
        position = -1;
    }

    object IEnumerator.Current
    {
        get
        {
            return Current;
        }
    }

    public Person Current
    {
        get
        {
            try
            {
                return _people[position];
            }
            catch (IndexOutOfRangeException)
            {
                throw new InvalidOperationException();
            }
        }
    }
}

' When you implement IEnumerable, you must also implement IEnumerator.
Public Class PeopleEnum
    Implements IEnumerator

    Public _people() As Person

    ' Enumerators are positioned before the first element
    ' until the first MoveNext() call.
    Dim position As Integer = -1

    Public Sub New(ByVal list() As Person)
        _people = list
    End Sub

    Public Function MoveNext() As Boolean Implements IEnumerator.MoveNext
        position = position + 1
        Return (position < _people.Length)
    End Function

    Public Sub Reset() Implements IEnumerator.Reset
        position = -1
    End Sub

    Public ReadOnly Property Current() As Object Implements IEnumerator.Current
        Get
            Try
                Return _people(position)
            Catch ex As IndexOutOfRangeException
                Throw New InvalidOperationException()
            End Try
        End Get
    End Property
End Class

Megjegyzések

Az enumerátor létrehozása vagy a Reset metódus meghívása után a rendszer a gyűjtemény első eleme elé helyezi az enumerátort, és a metódus első hívása MoveNext a gyűjtemény első eleme fölé helyezi az enumerátort.

Ha MoveNext a gyűjtemény végére ér, az enumerátor a gyűjtemény utolsó eleme után lesz elhelyezve, és MoveNext visszaadja a függvényt false. Ha az enumerátor ebben a pozícióban van, az azt követő hívások is visszatérnek MoveNextfalse , amíg meg nem Reset hívják.

Ha módosítják a gyűjteményt, például elemeket adnak hozzá, módosítanak vagy törölnek, a rendszer nem definiálja a viselkedését MoveNext .

Lásd még

• Current
• Reset()