DBProviderInfoEnumerator.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.

Gibt das aktuelle DBProviderInfo-Objekt aus der Auflistung zurück.

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

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

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

Public ReadOnly Property Current As DBProviderInfo

Eigenschaftswert

DBProviderInfo

Das aktuelle DBProviderInfo-Objekt.

Beispiele

Im folgenden Codebeispiel wird ein Aufzählungszeichen erstellt und dann die Current Methoden MoveNext zum Navigieren über die Auflistung verwendet.

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

namespace DBProvInfos_GetEnum  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  
            DBProviderInfos dbprovInfos = app.DBProviderInfos;  

            //Create the Enumerator.  
            DBProviderInfoEnumerator myEnumerator = dbprovInfos.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 DBProvInfos_GetEnum  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   
            Dim dbprovInfos As DBProviderInfos =  app.DBProviderInfos   

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

Beispielausgabe:

Die Auflistung enthält die folgenden Werte:

Hinweise

Nachdem ein Aufzählungszeichen erstellt wurde, oder nachdem ein Aufruf Reset der Methode aufgerufen wurde, muss die MoveNext Methode aufgerufen werden, um den Aufzählungsator auf das erste Element der Auflistung zu aktualisieren, 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 wird MoveNextfalse, der das Ende der Auflistung angibt.

Current verschiebt die Position des Enumerators nicht, und fortlaufende Aufrufe, um Current dasselbe Objekt zurückzugeben, bis sie entweder MoveNext oder Reset 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; So wird der nächste Aufruf an MoveNext oder Reset löst eine InvalidOperationException. Wenn die Auflistung jedoch zwischen MoveNext aufrufen und Currentgeändert wird, Current gibt das Element zurück, auf das er festgelegt ist, auch wenn der Aufzählerator ungültig wurde.

Gilt für:

Freigeben über