Freigeben über


BreakpointTargetEnumerator Klasse

Definition

Erstellt BreakpointTargetEnumerator für die BreakpointTargets-Auflistung. Diese Klasse kann nicht vererbt werden.

public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumerator
public sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumerator
type BreakpointTargetEnumerator = class
    inherit DtsEnumerator
Public NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator
Vererbung
BreakpointTargetEnumerator

Hinweise

Enumeratoren ermöglichen lediglich das Lesen der Daten in der Auflistung. Enumeratoren können nicht verwendet werden, um die zugrunde liegende Auflistung zu ändern.

Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. Die Reset Methode bringt auch den Aufzählungsator zurück an diese Position. An dieser Position löst das Aufrufen der Current Eigenschaft eine Ausnahme aus. Daher müssen Sie die Methode aufrufen MoveNext , um den Aufzählungsator zum ersten Element der Auflistung zu wechseln, bevor Sie den Wert lesen Current.

Current gibt solange dasselbe Objekt zurück, bis MoveNext oder Reset aufgerufen wird. MoveNext legt Current auf das nächste Element fest.

Nach Erreichen des Endes der Auflistung befindet sich der Enumerator hinter dem letzten Element der Auflistung, und ein Aufruf von MoveNext gibt false zurück. Wenn der letzte anruf, der zurückgegeben werden falsesollMoveNext, löst der Aufruf Current eine Ausnahme aus. Um Current wieder auf das erste Element der Auflistung festzulegen, können Sie Reset gefolgt von MoveNext aufrufen.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. Hinzufügen, Ändern oder Löschen von Elementen, wird der Aufzählungsator ungültig und kann nicht wiederhergestellt werden; so wird der nächste Aufruf MoveNext ausgelöst oder Reset ein InvalidOperationException. Wenn die Auflistung jedoch zwischen MoveNext und CurrentCurrent , gibt das Element zurück, auf das sie festgelegt ist, auch wenn der Aufzählungsator ungültig wurde.

Der Aufzählungsgeber hat keinen exklusiven Zugriff auf die Sammlung; Daher ist das Aufzählen durch eine Sammlung kein Threadsicheres Verfahren. Auch wenn eine Auflistung synchronisiert wird, könnten andere Threads die Auflistung weiterhin ändern, was dazu führt, dass der Aufzählungsator eine Ausnahme auslöst. Um während der Enumeration Threadsicherheit zu gewährleisten, können Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen, die aus von anderen Threads stammenden Änderungen resultieren, abfangen.

Eigenschaften

Current

Ruft das aktuelle BreakpointTarget-Objekt in der Auflistung ab.

Methoden

MoveNext()

Setzt den Enumerator auf das nächste Element der Auflistung.

(Geerbt von DtsEnumerator)
Reset()

Setzt den Enumerator auf seine anfängliche Position vor dem ersten Element in der Auflistung.

(Geerbt von DtsEnumerator)

Gilt für: