PipelineComponentInfoEnumerator.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'élément PipelineComponentInfo actuel de la collection.

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

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

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

Public ReadOnly Property Current As PipelineComponentInfo

Valeur de propriété

PipelineComponentInfo

Élément PipelineComponentInfo actuel dans la collection.

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.

[C#]

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();  
            PipelineComponentInfos pInfos = app.PipelineComponentInfos;  

            //Create the Enumerator.  
            PipelineComponentInfoEnumerator myEnumerator= pInfos.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);  
        }  
    }  
}

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 pInfos As PipelineComponentInfos =  app.PipelineComponentInfos   

            'Create the Enumerator.  
            Dim myEnumeratorAs PipelineComponentInfoEnumerator =  pInfos.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  
        End Sub  
    End Class  
End Namespace

Exemple de sortie :

La collection contient les valeurs suivantes :

[0] Fusion

[1] Jointure de fusion

[2] Recherche

[3] Audit

[4] Échantillonnage de lignes

[5] Traitement de dimension

[6] Extraction de termes

Formation du modèle d’exploration de données [7]

[8] Source OLE DB

[9] Carte de caractères

[10] Regroupement flou

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 une exception est levée.

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 pour Current retourner le même objet tant que l’un MoveNext ou Reset l’autre n’est pas 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. Toutefois, si la collection est modifiée entre les appels et MoveNextCurrent, Current retourne l’élément sur lequel il est défini, même si l’énumérateur a été invalidé.

S’applique à

Share via