IEnumeratorContract<T> Schnittstelle
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.
Listet die Elemente in einer IListContract<T>-Auflistung auf.
generic <typename T>
public interface class IEnumeratorContract : IDisposablepublic interface IEnumeratorContract<T> : IDisposabletype IEnumeratorContract<'T> = interface
interface IDisposablePublic Interface IEnumeratorContract(Of T)
Implements IDisposableTypparameter
- 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. |
