BreakpointTargetEnumerator Classe

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Crée un objet BreakpointTargetEnumerator pour la collection BreakpointTargets. Cette classe ne peut pas être héritée.

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

Héritage

Object

DtsEnumerator

BreakpointTargetEnumerator

Remarques

Les énumérateurs permettent uniquement de lire les données dans la collection. Les énumérateurs ne peuvent pas être utilisés pour modifier la collection sous-jacente.

Au départ, l'énumérateur est positionné avant le premier élément de la collection. La Reset méthode ramène également l’énumérateur à cette position. À cette position, l’appel de la Current propriété lève une exception. Par conséquent, vous devez appeler MoveNext la méthode pour avancer l’énumérateur vers le premier élément de la collection avant de lire la valeur de Current.

Current retourne le même objet tant que MoveNext ou Reset n'est pas appelé. MoveNext affecte l'élément suivant à Current.

Une fois la collection terminée, l’énumérateur est placé après le dernier élément de la collection et l’appel à MoveNext retourne la valeur false. Si le dernier appel à MoveNext retourner false, l’appel Current lève une exception. Pour attribuer une nouvelle fois Current au premier élément de la collection, vous pouvez appeler Reset suivi de MoveNext.

Un énumérateur reste valide aussi longtemps que la collection demeure inchangée. Si des modifications sont apportées à la collection, comme l’ajout, la modification ou la suppression d’éléments, l’énumérateur est invalidé et devient irrécupérable ; par conséquent, l’appel suivant à MoveNext ou Reset lève un InvalidOperationException. Toutefois, si la collection est modifiée entre MoveNext et Current, Current retourne l’élément sur lequel il est défini, même si l’énumérateur a été invalidé.

L’énumérateur n’a pas accès exclusif à la collection; par conséquent, l’énumération via une collection n’est pas une procédure thread-safe. Même lorsqu’une collection est synchronisée, d’autres threads peuvent toujours modifier la collection, ce qui entraîne la levée d’une exception par l’énumérateur. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.

Propriétés

Current

Obtient l'objet BreakpointTarget actuel dans la collection.

Méthodes

MoveNext()	Avance l’énumérateur à l’élément suivant de la collection. (Hérité de DtsEnumerator)
Reset()	Rétablit l’énumérateur à sa position initiale, qui précède le premier élément de la collection. (Hérité de DtsEnumerator)