BreakpointTargetEnumerator.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 BreakpointTarget-Objekt in der Auflistung ab.

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

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

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

Public ReadOnly Property Current As BreakpointTarget

Eigenschaftswert

BreakpointTarget

Das aktuelle BreakpointTarget-Objekt in der Auflistung.

Beispiele

Im folgenden Codebeispiel wird ein Aufzählungszeichen 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;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  

namespace BreakpointTarget_Expression  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package pkg = new Package();  
            TaskHost taskHost = (TaskHost)pkg.Executables.Add("STOCK:FileSystemTask");  
            BreakpointTargets bptargets = pkg.GetBreakpointTargets(taskHost, false);  
            // Create the enumerator.  
            BreakpointTargetEnumerator myEnumerator = bptargets.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.Description);  
        }  
    }  
}

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

Namespace BreakpointTarget_Expression  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim pkg As Package =  New Package()   
            Dim taskHost As TaskHost = CType(pkg.Executables.Add("STOCK:FileSystemTask"), TaskHost)  
            Dim bptargets As BreakpointTargets =  pkg.GetBreakpointTargets(taskHost,False)   
            ' Create the enumerator.  
            Dim myEnumerator As BreakpointTargetEnumerator =  bptargets.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] Pause, wenn der Container das OnPreExecute-Ereignis empfängt

[1] Pause, wenn der Container das OnPostExecute-Ereignis empfängt

[2] Unterbrechen, wenn der Container das OnError-Ereignis empfängt

[3] Unterbrechen, wenn der Container das OnWarning-Ereignis empfängt

[4] Unterbrechen, wenn der Container das OnInformation-Ereignis empfängt

[5] Unterbrechen, wenn der Container das OnTaskFailed-Ereignis empfängt

[6] Unterbrechen, wenn der Container das OnProgress-Ereignis empfängt

[7] Pause, wenn der Container das OnQueryCancel-Ereignis empfängt

[8] Pause, wenn der Container das OnVariableValueChanged-Ereignis empfängt

[9] Unterbrechen, wenn der Container das OnCustomEvent-Ereignis empfängt

Hinweise

Nachdem ein Aufzählerator 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 ist unbekannt und löst eine Ausnahme aus.

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 unwiederwendbar, so dass der nächste Aufruf an MoveNext oder Reset ausgelöst wird InvalidOperationException. Wenn die Auflistung zwischen MoveNext und Current, Current gibt das Element zurück, auf das sie festgelegt ist, auch wenn der Aufzählungsator bereits ungültig ist.

Gilt für:

Share via