Teilen über


IEnumeratorContract<T> Schnittstelle

Definition

Listet die Elemente in einer IListContract<T>-Auflistung auf.

generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
    interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable

Typparameter

T

Der Typ der aufzulistenden Objekte.

Implementiert

Hinweise

Enumeratoren können verwendet werden, um die Daten in der Sammlung zu lesen, aber sie können nicht zum Ändern der Auflistung verwendet werden.

Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. An dieser Position ist der Rückgabewert von GetCurrent nicht definiert. Aus diesem Grund müssen Sie aufrufen MoveNext , um den Enumerator auf das erste Element der Auflistung vor dem Aufrufen von zu verdrücken GetCurrent.

GetCurrent gibt solange dasselbe Objekt zurück, bis MoveNext aufgerufen wird. MoveNext legt den Rückgabewert von GetCurrent auf das nächste Element fest.

Wenn MoveNext das Ende der Auflistung übergibt, wird der Enumerator hinter dem letzten Element in der Auflistung platziert, und MoveNext gibt false zurück. Wenn sich der Enumerator an dieser Position befindet, geben nachfolgende Aufrufe von MoveNext auch false zurück. Wenn der letzte Aufruf von MoveNext zurückgegeben wurde false, ist der Rückgabewert von GetCurrent nicht definiert.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Werden an der Auflistung Änderungen wie z. B. Hinzufügen, Bearbeiten oder Entfernen von Elementen vorgenommen, verliert der Enumerator unwiederbringlich seine Gültigkeit und sein Verhalten ist nicht definiert.

Methoden

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

(Geerbt von IDisposable)
GetCurrent()

Gibt das Objekt in der Auflistung an der aktuellen Position des Enumerators zurück.

MoveNext()

Setzt den Enumerator auf das nächste Element der Auflistung.

Reset()

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

Gilt für: