EventInfos.GetEnumerator 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.
Gibt einen Enumerator zum Durchlaufen der EventInfos-Auflistung zurück.
public:
Microsoft::SqlServer::Dts::Runtime::EventInfoEnumerator ^ GetEnumerator();
public Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator GetEnumerator ();
override this.GetEnumerator : unit -> Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator
Public Function GetEnumerator () As EventInfoEnumerator
Gibt zurück
Ein EventInfoEnumerator-Objekt.
Hinweise
Aufzählungen sollen nur verwendet werden, um Daten in der Sammlung zu lesen. Aufzählungen können nicht verwendet werden, um die zugrunde liegende Auflistung zu ändern.
Der Aufzählerator hat keinen exklusiven Zugriff auf die Sammlung.
Wenn ein Aufzählerator erstellt wird, nimmt er eine Momentaufnahme des aktuellen Zustands der Auflistung an. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. Hinzufügen, Ändern oder Löschen von Elementen, wird die Momentaufnahme nicht synchronisiert, und der Aufzählungsator löst eine InvalidOperationException
. Zwei Aufzählungen, die aus derselben Auflistung gleichzeitig erstellt wurden, können unterschiedliche Momentaufnahmen der Auflistung aufweisen.
Der Aufzählungsator befindet sich in einem Zustand, der nicht gültig ist, wenn es vor dem ersten Element in der Auflistung oder nach dem letzten Element in der Auflistung positioniert ist. Wenn sich der Aufzählungsator in einem Zustand befindet, der nicht gültig ist, löst der Aufruf Current
eine Ausnahme aus.
Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. Reset
setzt den Enumerator ebenfalls auf diese Position zurück. Daher muss nach dem Erstellen oder Nachlesen Reset
MoveNext
eines Aufzählungszeichens aufgerufen werden, um den Aufzählerator auf das erste Element der Auflistung zu aktualisieren, bevor er den Wert Current
liest.
Current
gibt solange dasselbe Objekt zurück, bis MoveNext
oder Reset
aufgerufen wird.
Nachdem das Ende der Auflistung übergeben wurde, befindet sich der Aufzählungsator erneut in einem Zustand, der ungültig ist und aufruft MoveNext
false
. Beim Aufrufen Current
wird eine Ausnahme ausgelöst, wenn der letzte Aufruf zurückgegeben false
wirdMoveNext
.