IDTSRuntimeConnection100.ConnectionManager Eigenschaft

Definition

Ruft das IDTSConnectionManager100-Objekt ab, auf das vom Laufzeitverbindungsobjekt verwiesen wird, oder legt es fest.

public:
 property Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSConnectionManager100 ^ ConnectionManager { Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSConnectionManager100 ^ get(); void set(Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSConnectionManager100 ^ value); };
[System.Runtime.InteropServices.DispId(102)]
public Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSConnectionManager100 ConnectionManager { [System.Runtime.InteropServices.DispId(102)] get; [System.Runtime.InteropServices.DispId(102)] set; }
[<System.Runtime.InteropServices.DispId(102)>]
[<get: System.Runtime.InteropServices.DispId(102)>]
[<set: System.Runtime.InteropServices.DispId(102)>]
member this.ConnectionManager : Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSConnectionManager100 with get, set
Public Property ConnectionManager As IDTSConnectionManager100

Eigenschaftswert

Die IDTSConnectionManager100 der Komponente.

Attribute

Beispiele

Das folgende Codebeispiel zeigt, wie die ConnectionManager Eigenschaft beim programmgesteuerten Laden eines Pakets festgelegt wird.

// TODO: Replace the path to the package with a valid path.  
string package = @"c:\Package.dtsx";  

// Create the application and load the package.  
Application a = new Application();  
Package p = a.LoadPackage( package , null );  

// Walk the Executables collection looking for data flow tasks.  
foreach (Executable e in p.Executables)  
{  
    MainPipe mp = ((TaskHost)e).InnerObject as MainPipe;  
    if( e != null )  
    {  
        // Walk the components.  
        foreach( IDTSComponentMetaData100 md in mp.ComponentMetaDataCollection )  
        {  
            // Walk the RuntimeConnectionCollection.  
            foreach( IDTSRuntimeConnection100 rc in md.RuntimeConnectionCollection )  
            {  
                // Check to see if the package's connections collection contains the   
                // Connectionmanager stored in the RuntimeConnection.  
                if (p.Connections.Contains(rc.ConnectionManagerID))  
                    rc.ConnectionManager = DtsConvert.ToConnectionManager100(p.Connections[rc.ConnectionManagerID]);  
                else  
                    Console.WriteLine("The ConnectionManager " + rc.ConnectionManagerID + " was not found in the Package's Connections collection.");  
            }  
        }  
    }  
}  
' TODO: Replace the path to the package with a valid path.  
Dim package As String = "c:\Package.dtsx"   

' Create the application and load the package.  
Dim a As Application = New Application   
Dim p As Package = a.LoadPackage(package, Nothing)   

' Walk the Executables collection looking for data flow tasks.  
For Each e As Executable In p.Executables   
 Dim mp As MainPipe = CType(CType(e, TaskHost).InnerObject, MainPipe)   
 If Not (e Is Nothing) Then   
   ' Walk the components.  
   For Each md As IDTSComponentMetaData100 In mp.ComponentMetaDataCollection   
     ' Walk the RuntimeConnectionCollection.  
     For Each rc As IDTSRuntimeConnection100 In md.RuntimeConnectionCollection   
       ' Check to see whether the package's connections collection    
       '  contains the Connectionmanager stored in the RuntimeConnection.  
       If p.Connections.Contains(rc.ConnectionManagerID) Then   
         rc.ConnectionManager = DtsConvert.ToConnectionManager100(p.Connections(rc.ConnectionManagerID))   
       Else   
         Console.WriteLine("The ConnectionManager " + rc.ConnectionManagerID + " was not found in the Package's Connections collection.")   
       End If   
     Next   
   Next   
 End If   
Next  

Hinweise

Die ConnectionManager Eigenschaft enthält oder legt einen Verweis auf die tatsächliche Instanz des IDTSConnectionManager100 Objekts im Paket fest. Zur Laufzeit wird dieser Verweis automatisch vom SSIS-Laufzeitmodul mithilfe der ConnectionManagerID Eigenschaft festgelegt, um die Verbindung im Paket zu suchen und einen Verweis zuzuweisen.

Zur Entwurfszeit führt SSIS Designer diese Zuordnung beim Laden und Initialisieren einer Komponente durch. Beim programmgesteuerten Laden und Bearbeiten einer Komponente muss die Eigenschaft jedoch explizit festgelegt werden, indem das Objektmodell außerhalb des Designers verwendet wird. Komponenten haben nicht die Möglichkeit, explizit mithilfe der ConnectionManagerID Eigenschaft auf die Verbindung zu verweisen, da die Connections Auflistung des Pakets nicht für Komponenten verfügbar gemacht wird.

Gilt für: