TaskInfoEnumerator.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 TaskInfo-Objekt aus der Auflistung ab.

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

Eigenschaftswert

TaskInfo

Das aktuelle TaskInfo-Objekt.

Beispiele

Im folgenden Codebeispiel wird ein Aufzählungszeichen erstellt, und anschließend werden die Current Und MoveNext-Methoden verwendet, um zur Auflistung zu navigieren.

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

Beispielausgabe:

Die Auflistung enthält die folgenden Werte:

[0] Ausführen der Paketaufgabe

[1] Datenfluss Vorgang

[2] SQL Server Analysis Services DDL-Aufgabe ausführen

[3] SQL Server Analysis Services Verarbeitungsaufgabe

[4] Massenvorgang einfügen

[5] Data Mining Query Task

[6] Ausführen der Prozessaufgabe

[7] Dateisystemaufgabe

[8] Dateiübertragungsprotokollaufgabe

Hinweise

Nachdem ein Aufzählungsator erstellt wurde oder nach einem Aufruf der Reset Methode aufgerufen werden muss, muss die MoveNext Methode aufgerufen werden, um das erste Element der Auflistung zu durchlaufen, bevor der Enumerationerator den Wert der Current Eigenschaft lesen kann; 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.

Currentverschiebt die Position des Aufzählers nicht, und aufeinander folgende Aufrufe zum Zurückgeben desselben Current Objekts werden erst dann aufgerufen, Reset wenn sie MoveNext aufgerufen werden.

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