PackageInfoEnumerator.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 PackageInfo-Element aus der Auflistung zurück.

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

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

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

Public ReadOnly Property Current As PackageInfo

Eigenschaftswert

PackageInfo

Ein PackageInfo-Objekt.

Beispiele

Im folgenden Codebeispiel werden zwei Pakete aus dem Ordner "Beispiele" geladen und im DTS-Dienst gespeichert. Anschließend wird eine Aufzählung erstellt und die MoveNext- und Current Methoden verwendet, um die Pakete zu durchlaufen und deren Namen zu drucken.

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

namespace PackageInfoTest  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            string pkg = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx";  
            string pkg2 = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";  

            Application app = new Application();  
            Package p1 = app.LoadPackage(pkg, null);  
            Package p2 = app.LoadPackage(pkg2, null);  
            p1.Description = "UsingExecuteProcess package";  
            p2.Description = "Calculated Columns package";  

            app.SaveToDtsServer(p1, null, @"File System\myp1Package", "YOURSERVER");  
            app.SaveToDtsServer(p2, null, @"File System\myp2Package", "YOURSERVER");  

            PackageInfos pInfos = app.GetDtsServerPackageInfos(@"File System", "YOURSERVER");  
            Console.WriteLine("Number of Packages {0}", pInfos.Count.ToString());  

            PackageInfoEnumerator iEnum = pInfos.GetEnumerator();  

            while (iEnum.MoveNext())  
                {  
                    String pkgName = iEnum.Current.Name;  
                    Console.WriteLine(pkgName);   
                }  
         }  
    }  
}

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

Namespace PackageInfoTest  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim pkg As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx"   
            Dim pkg2 As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"   

            Dim app As Application =  New Application()   
            Dim p1 As Package =  app.LoadPackage(pkg,Nothing)   
            Dim p2 As Package =  app.LoadPackage(pkg2,Nothing)   
            p1.Description = "UsingExecuteProcess package"  
            p2.Description = "Calculated Columns package"  

            app.SaveToDtsServer(p1, Nothing, "File System\myp1Package", "YOURSERVER")  
            app.SaveToDtsServer(p2, Nothing, "File System\myp2Package", "YOURSERVER")  

            Dim pInfos As PackageInfos =  app.GetDtsServerPackageInfos("File System","YOURSERVER")   
            Console.WriteLine("Number of Packages {0}", pInfos.Count.ToString())  

            Dim iEnum As PackageInfoEnumerator =  pInfos.GetEnumerator()   

            While iEnum.MoveNext()  
                    Dim pkgName As String =  iEnum.Current.Name   
                    Console.WriteLine(pkgName)  
            End While  
        End Sub  
    End Class  
End Namespace

Beispielausgabe:

Anzahl der Pakete 2

myp1Package

myp2Package

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.

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 jedoch zwischen aufrufen MoveNext und Currentgeändert wird, Current gibt das Element zurück, auf das sie festgelegt ist, auch wenn der Aufzählungsator ungültig wurde.

Gilt für:

Freigeben über