EventInfos.GetEnumerator Methode

Definition

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 ResetMoveNext eines Aufzählungszeichens aufgerufen werden, um den Aufzählerator auf das erste Element der Auflistung zu aktualisieren, bevor er den Wert Currentliest.

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 MoveNextfalse. Beim Aufrufen Current wird eine Ausnahme ausgelöst, wenn der letzte Aufruf zurückgegeben falsewirdMoveNext.

Gilt für: