BreakpointTargetEnumerator.Current Propriété

Référence

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient l'objet BreakpointTarget actuel dans la collection.

public:
 property Microsoft::SqlServer::Dts::Runtime::BreakpointTarget ^ Current { Microsoft::SqlServer::Dts::Runtime::BreakpointTarget ^ get(); };

public Microsoft.SqlServer.Dts.Runtime.BreakpointTarget Current { get; }

member this.Current : Microsoft.SqlServer.Dts.Runtime.BreakpointTarget

Public ReadOnly Property Current As BreakpointTarget

Valeur de propriété

BreakpointTarget

Objet BreakpointTarget actuel dans la collection.

Exemples

L’exemple de code suivant crée un énumérateur, puis utilise les méthodes et MoveNext les Current méthodes pour parcourir la collection.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  

namespace BreakpointTarget_Expression  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package pkg = new Package();  
            TaskHost taskHost = (TaskHost)pkg.Executables.Add("STOCK:FileSystemTask");  
            BreakpointTargets bptargets = pkg.GetBreakpointTargets(taskHost, false);  
            // Create the enumerator.  
            BreakpointTargetEnumerator myEnumerator = bptargets.GetEnumerator();  
            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            while ((myEnumerator.MoveNext()) && (myEnumerator.Current != null))  
                Console.WriteLine("[{0}] {1}", i++, myEnumerator.Current.Description);  
        }  
    }  
}

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  

Namespace BreakpointTarget_Expression  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim pkg As Package =  New Package()   
            Dim taskHost As TaskHost = CType(pkg.Executables.Add("STOCK:FileSystemTask"), TaskHost)  
            Dim bptargets As BreakpointTargets =  pkg.GetBreakpointTargets(taskHost,False)   
            ' Create the enumerator.  
            Dim myEnumerator As BreakpointTargetEnumerator =  bptargets.GetEnumerator()   
            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            While (myEnumerator.MoveNext()) &&(myEnumerator.Current <> Nothing)  
            Console.WriteLine("[{0}] {1}",i = Console.WriteLine("[{0}] {1}",i + 1  
            End While  
        End Sub  
    End Class  
End Namespace

Exemple de sortie :

La collection contient les valeurs suivantes :

[0] Arrêt lorsque le conteneur reçoit l’événement OnPreExecute

[1] Arrêter lorsque le conteneur reçoit l’événement OnPostExecute

[2] Arrêter lorsque le conteneur reçoit l’événement OnError

[3] Arrêter lorsque le conteneur reçoit l’événement OnWarning

[4] Arrêter lorsque le conteneur reçoit l’événement OnInformation

[5] Arrêter lorsque le conteneur reçoit l’événement OnTaskFailed

[6] Arrêt lorsque le conteneur reçoit l’événement OnProgress

[7] Arrêter lorsque le conteneur reçoit l’événement OnQueryCancel

[8] Arrêt lorsque le conteneur reçoit l’événement OnVariableValueChanged

[9] Arrêt lorsque le conteneur reçoit l’événement OnCustomEvent

Remarques

Une fois qu’un énumérateur est créé ou après un appel à la Reset méthode, la MoveNext méthode doit être appelée pour avancer l’énumérateur vers le premier élément de la collection avant de lire la valeur de la Current propriété ; sinon, Current elle lève une exception.

Current lève également une exception si le dernier appel à MoveNext renvoyer false, qui indique la fin de la collection.

Current ne déplace pas la position de l’énumérateur, et les appels consécutifs pour renvoyer le même objet jusqu’à Current ce que l’un MoveNext ou Reset l’autre soit appelé.

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 irrécupérable, par conséquent, l’appel suivant à MoveNext ou Reset lève un InvalidOperationException. 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 est déjà invalidé.

S’applique à

Share via