TaskInfoEnumerator.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 TaskInfo actuel à partir de la collection.

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

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

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

Public ReadOnly Property Current As TaskInfo

Valeur de propriété

TaskInfo

Objet TaskInfo actuel.

Exemples

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

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

namespace TaskInfos_Item  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  
            TaskInfos tInfos = app.TaskInfos;  
            //Create the Enumerator.  
            TaskInfoEnumerator myEnumerator = tInfos.GetEnumerator();  
            Console.WriteLine("The collection contains the following values:");  
            int i = 0;  
            while ((myEnuemrator.MoveNext()) && (myEnuemrator.Current != null))  
                Console.WriteLine("[{0}] {1}", i++, myEnuemrator.Current.Name);  

            Console.WriteLine();  
        }  
    }  
}

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

Namespace TaskInfos_Item  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   
            Dim tInfos As TaskInfos =  app.TaskInfos   
            'Create the Enumerator.  
            Dim myEnumerator As TaskInfoEnumerator =  tInfos.GetEnumerator()   
            Console.WriteLine("The collection contains the following values:")  
            Dim i As Integer =  0   
            While (myEnuemrator.MoveNext()) &&(myEnuemrator.Current <> Nothing)  
            Console.WriteLine("[{0}] {1}",i = Console.WriteLine("[{0}] {1}",i + 1  
            End While  

            Console.WriteLine()  
        End Sub  
    End Class  
End Namespace

Exemple de sortie :

La collection contient les valeurs suivantes :

[0] Exécuter la tâche de package

[1] tâche de Data Flow

[2] SQL Server Analysis Services exécuter une tâche DDL

[3] tâche de traitement de SQL Server Analysis Services

[4] Tâche d’insertion en bloc

[5] Tâche de requête d’exploration de données

[6] Exécuter la tâche de processus

[7] Tâche de système de fichiers

[8] Tâche de protocole de transfert de fichiers

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 faire passer l’énumérateur au premier élément de la collection avant que l’énumérateur puisse lire la valeur de la Current propriété ; sinon, Current elle n’est pas définie et lève une exception.

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

Current ne déplace pas la position de l’énumérateur et les appels consécutifs au retour du Current même objet jusqu’à 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, telles que l’ajout, la modification ou la suppression d’éléments, l’énumérateur est invalidé et devient irrécupérable ; ainsi, l’appel suivant à MoveNext ou Reset lève un InvalidOperationException. Si la collection est modifiée entre les appels à MoveNext et Current, Current retourne l’élément sur lequel il est défini, même si l’énumérateur a été invalidé.

S’applique à

Partager via