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 zurück, der zum Iterieren der EventInfos Sammlung verwendet werden kann.
public:
Microsoft::SqlServer::Dts::Runtime::EventInfoEnumerator ^ GetEnumerator();public Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator GetEnumerator();override this.GetEnumerator : unit -> Microsoft.SqlServer.Dts.Runtime.EventInfoEnumeratorPublic Function GetEnumerator () As EventInfoEnumeratorGibt zurück
Ein EventInfoEnumerator-Objekt.
Hinweise
Enumeratoren sind ausschließlich dazu gedacht, Daten in der Sammlung auszulesen. Enumeratoren können nicht zum Ändern der zugrunde liegenden Auflistung verwendet werden.
Der Enumerator hat keinen exklusiven Zugriff auf die Sammlung.
Wenn ein Enumerator erstellt wird, wird eine Momentaufnahme des aktuellen Zustands der Auflistung erstellt. Wenn Änderungen an der Sammlung vorgenommen werden, wie das Hinzufügen, Ändern oder Löschen von Elementen, gerät der Snapshot aus der Synchronisation und der Enumerator wirft ein InvalidOperationException. Zwei Enumeratoren, die gleichzeitig aus derselben Sammlung erstellt werden, können unterschiedliche Snapshots der Sammlung haben.
Der Enumerator befindet sich in einem Zustand, der nicht gültig ist, wenn er vor dem ersten Element in der Sammlung oder nach dem letzten Element in der Sammlung positioniert ist. Immer wenn sich der Einventator in einem Zustand befindet, der nicht gültig ist, wirft das Aufrufen Current eine Ausnahme aus.
Zunächst wird der Enumerator vor dem ersten Element in der Auflistung positioniert.
Reset bringt den Enumerator auch wieder an diese Position zurück. Daher muss nach der Erstellung eines Enumerators oder danach Resetaufgerufen MoveNext werden, um den Enumerator auf das erste Element der Sammlung vorzuschieben, bevor er den Wert von Currentliest.
Current gibt dasselbe Objekt zurück, bis eine MoveNext oder Reset mehrere Aufrufe ausgeführt werden.
Nachdem das Ende der Sammlung passiert ist, befindet sich der Enumerator erneut in einem ungültigen Zustand, und der Aufruf MoveNext ergibt .false Beim Aufrufen Current wird eine Ausnahme ausgelöst, wenn der letzte aufruf, der zurückgegeben werden soll MoveNextfalse.