IEnumerator.Reset Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Setzt den Enumerator auf seine anfängliche Position vor dem ersten Element in der Auflistung.
public:
void Reset();
public void Reset ();
abstract member Reset : unit -> unit
Public Sub Reset ()
Ausnahmen
Die Sammlung wurde nach der Erstellung des Enumerators geändert.
Beispiele
Im folgenden Codebeispiel wird die Implementierung der IEnumerator Schnittstellen für eine benutzerdefinierte Auflistung veranschaulicht. In diesem Beispiel Reset wird nicht explizit aufgerufen, aber es wird implementiert, um die Verwendung von foreach
(for each
in Visual Basic) zu unterstützen. Dieses Codebeispiel ist Teil eines größeren Beispiels für die IEnumerator Schnittstelle.
// 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
Hinweise
Wenn Änderungen an der Auflistung vorgenommen werden, z. B. das Hinzufügen, Ändern oder Löschen von Elementen, ist das Verhalten von Reset nicht definiert.
Die Reset Methode wird für die COM-Interoperabilität bereitgestellt. Sie muss nicht unbedingt umgesetzt werden; Stattdessen kann der Implementierer einfach einen NotSupportedExceptionauslösen.
Hinweise für Ausführende
Alle Aufrufe von Reset() müssen zum gleichen Zustand für den Enumerator führen. Die bevorzugte Implementierung besteht darin, den Enumerator an den Anfang der Auflistung vor dem ersten Element zu verschieben. Dadurch wird der Enumerator ungültig, wenn die Auflistung seit der Erstellung des Enumerators geändert wurde, was mit MoveNext() und Currentkonsistent ist.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Feedback senden und anzeigen für