IEnumeratorContract<T> IEnumeratorContract<T> IEnumeratorContract<T> IEnumeratorContract<T> Interface

Definition

Listet die Elemente in einer IListContract<T>-Auflistung auf.Enumerates the elements in an IListContract<T> collection.

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.The type of objects being enumerated.

Implementiert

Hinweise

Enumeratoren können verwendet werden, um die Daten in der Auflistung zu lesen, aber sie können nicht zum Ändern der Auflistung verwendet werden.Enumerators can be used to read the data in the collection, but they cannot be used to modify the collection.

Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert.Initially, the enumerator is positioned before the first element in the collection. An dieser Position ist der Rückgabewert von GetCurrent ist nicht definiert.At this position, the return value of GetCurrent is undefined. Aus diesem Grund müssen Sie aufrufen MoveNext auf den Enumerator auf das erste Element der Auflistung vor dem Aufruf GetCurrent.Therefore, you must call MoveNext to advance the enumerator to the first element of the collection before calling GetCurrent.

GetCurrent gibt solange dasselbe Objekt zurück, bis MoveNext aufgerufen wird.GetCurrent returns the same object until MoveNext is called. MoveNext Legt den Rückgabewert der GetCurrent auf das nächste Element.MoveNext sets the return value of GetCurrent to the next element.

Wenn MoveNext das Ende der Auflistung übergibt, wird der Enumerator hinter dem letzten Element in der Auflistung platziert, und MoveNext gibt false zurück.If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. Wenn sich der Enumerator an dieser Position befindet, geben nachfolgende Aufrufe von MoveNext auch false zurück.When the enumerator is at this position, subsequent calls to MoveNext also return false. Wenn der letzte Aufruf MoveNext zurückgegebenen false, der Rückgabewert von GetCurrent ist nicht definiert.If the last call to MoveNext returned false, the return value of GetCurrent is undefined.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert ist.An enumerator remains valid as long as the collection remains unchanged. 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.If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and its behavior is undefined.

Methoden

Dispose() Dispose() Dispose() Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from IDisposable)
GetCurrent() GetCurrent() GetCurrent() GetCurrent()

Gibt das Objekt in der Auflistung an der aktuellen Position des Enumerators zurück.Returns the object in the collection at the current position of the enumerator.

MoveNext() MoveNext() MoveNext() MoveNext()

Setzt den Enumerator auf das nächste Element der Auflistung.Advances the enumerator to the next element of the collection.

Reset() Reset() Reset() Reset()

Setzt den Enumerator auf seine anfängliche Position vor dem ersten Element in der Auflistung.Sets the enumerator to its initial position, which is before the first element in the collection.

Gilt für: