ConnectionEnumerator.Current Eigenschaft

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das aktuelle ConnectionManager-Objekt aus der Connections-Auflistung ab.

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

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

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

Public ReadOnly Property Current As ConnectionManager

Eigenschaftswert

ConnectionManager

Ein ConnectionManager-Objekt.

Beispiele

Im folgenden Codebeispiel wird eine Aufzählung erstellt und anschließend die CurrentMoveNext Methoden verwendet, um über die Auflistung zu navigieren.

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

namespace ConnMgr_GetEnum_Current  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // The package is one of the SSIS Samples.  
            string mySample = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";  
            // Create the application, and load the sample.  
            Application app = new Application();  
            Package pkg = app.LoadPackage(mySample, null);  

            // Get the Connections collection from the package.  
            Connections conns = pkg.Connections;  

            //Create the Enumerator.  
            ConnectionEnumerator myEnumerator = conns.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.Name);  
        }  
    }  
}

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

Namespace ConnMgr_GetEnum_Current  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            ' The package is one of the SSIS Samples.  
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"   
            ' Create the application, and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   

            ' Get the Connections collection from the package.  
            Dim conns As Connections =  pkg.Connections   

            'Create the Enumerator.  
            Dim myEnumerator As ConnectionEnumerator =  conns.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

Beispielausgabe:

Die Auflistung enthält die folgenden Werte:

[0] localhost. Adventureworks

[1] Transaktionszusammenfassung nach Produkt1

Hinweise

Nachdem eine Aufzählung erstellt wurde oder nach einem Aufruf der Reset Methode aufgerufen werden muss, muss die MoveNext Methode aufgerufen werden, um den Aufzählungsator zum ersten Element der Auflistung zu wechseln, bevor der Wert der Current Eigenschaft gelesen wird. Andernfalls Current wird eine Ausnahme ausgelöst.

Current Löst auch eine Ausnahme aus, wenn der letzte Aufruf zurückgegeben MoveNext wird false, der das Ende der Auflistung angibt.

Current verschiebt die Position des Aufzählungsators nicht, und aufeinander folgende Aufrufe, um Current dasselbe Objekt zurückzugeben, bis eine MoveNext oder Reset die aufgerufen wird.

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; der nächste Aufruf MoveNextReset oder löst einen InvalidOperationException. Wenn die Auflistung zwischen aufrufen MoveNext und Currentgeändert wird, Current gibt das Element zurück, auf das sie festgelegt ist, auch wenn der Enumerationsgeber ungültig wurde.

Gilt für:

Freigeben über