IEnumerator.Reset Metod

Definition

Namnområde:
System.Collections
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
netstandard.dll

Anger uppräknaren till sin ursprungliga position, som är före det första elementet i samlingen.

public:
 void Reset();
public void Reset();
abstract member Reset : unit -> unit
Public Sub Reset ()

Undantag

InvalidOperationException

Samlingen ändrades efter att uppräknaren skapades.

NotSupportedException

Uppräknaren stöder inte återställning.

Exempel

I följande kodexempel visas implementeringen av gränssnitten IEnumerator för en anpassad samling. I det här exemplet anropas inte Reset uttryckligen, men det implementeras för att stödja användningen av foreach (for each i Visual Basic). Det här kodexemplet är en del av ett större exempel för IEnumerator gränssnittet.

// 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

Kommentarer

Om ändringar görs i samlingen, till exempel att lägga till, ändra eller ta bort element, är beteendet Reset för odefinierat.

Metoden Reset tillhandahålls för COM-samverkan. Det behöver inte nödvändigtvis genomföras. i stället kan implementeraren helt enkelt kasta en NotSupportedException.

Anteckningar till implementerare

Alla anrop till Reset() måste resultera i samma tillstånd för uppräknaren. Den föredragna implementeringen är att flytta uppräknaren till början av samlingen, före det första elementet. Detta ogiltigförklarar uppräknaren om samlingen har ändrats sedan uppräknaren skapades, vilket är konsekvent med MoveNext() och Current.

Gäller för

Se även