IEnumerator.Reset-Methode

Artikel
08/20/2007

Setzt den Enumerator auf seine anfängliche Position vor dem ersten Element in der Auflistung.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Sub Reset
'Usage
Dim instance As IEnumerator

instance.Reset

void Reset ()

void Reset ()

void Reset ()

function Reset ()

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die Auflistung wurde nach dem Erstellen des Enumerators geändert.

Hinweise

Ein Enumerator bleibt so lange gültig, bis die Auflistung geändert wird. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. durch Hinzufügen, Ändern oder Entfernen von Elementen, ist der Enumerator unwiderruflich ungültig, und der nächste Aufruf der MoveNext-Methode oder der Reset-Methode löst eine InvalidOperationException aus.

Hinweise für Implementierer Alle Aufrufe von Reset müssen zu demselben Zustand des Enumerators führen. Die bevorzugte Implementierung besteht darin, dass der Enumerator an den Anfang der Auflistung, vor das erste Element gesetzt wird. Hierbei wird der Enumerator für ungültig erklärt, wenn die Auflistung seit dem Erstellen des Enumerators geändert wurde. Das Verhalten stimmt so mit dem von MoveNext und Current überein.

Beispiel

Im folgenden Codebeispiel wird die Implementierung von IEnumerator-Schnittstellen für eine benutzerdefinierte Auflistung veranschaulicht. In diesem Beispiel wird Reset nicht explizit aufgerufen, sondern es wird zur Unterstützung der Verwendung von foreach (for each in Visual Basic) implementiert. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die IEnumerator-Schnittstelle.

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

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;
    }

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IEnumerator-Schnittstelle
IEnumerator-Member
System.Collections-Namespace
MoveNext
Current

Freigeben über