Connections.Add(String) Methode

Definition

Fügt der ConnectionManager-Auflistung ein Connections-Objekt des angegebenen Verbindungstyps hinzu.

public:
 Microsoft::SqlServer::Dts::Runtime::ConnectionManager ^ Add(System::String ^ connectionType);
public Microsoft.SqlServer.Dts.Runtime.ConnectionManager Add (string connectionType);
member this.Add : string -> Microsoft.SqlServer.Dts.Runtime.ConnectionManager
Public Function Add (connectionType As String) As ConnectionManager

Parameter

connectionType
String

Dieser Parameter gibt den Verbindungstyp an. Die Zeichenfolge "FILE" gibt z. B. einen Verbindungs-Manager für Dateien an.

Gibt zurück

Das neue ConnectionManager-Objekt, das der Connections-Auflistung hinzugefügt wurde.

Beispiele

Im folgenden Codebeispiel wird ein ADO.NET Verbindungs-Manager zu einem Paket hinzugefügt, das zwei vorhandene Verbindungen enthält.

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

namespace ConnMgr_GetEnum_Current  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // The package is one of the SSIS Samples.  
            string mySample = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";  
            // Create an application and load the sample.  
            Application app = new Application();  
            Package pkg = app.LoadPackage(mySample, null);  

            // Get the Connections collection from the package.  
            Connections conns = pkg.Connections;  

            // Count the number of connections in the package.  
            int myConns = conns.Count;  
            Console.WriteLine("The number of connections is: {0}", myConns);  

            //Add a new connection manager to the collection.  
            conns.Add("ADO.NET");  
            myConns = conns.Count;  
            Console.WriteLine("The number of connections now is: {0}", myConns);  
        }  
    }  
}  
Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace ConnMgr_GetEnum_Current  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            ' The package is one of the SSIS Samples.  
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"   
            ' Create an application and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   

            ' Get the Connections collection from the package.  
            Dim conns As Connections =  pkg.Connections   

            ' Count the number of connections in the package.  
            Dim myConns As Integer =  conns.Count   
            Console.WriteLine("The number of connections is: {0}", myConns)  

            'Add a new connection manager to the collection.  
            conns.Add("ADO.NET")  
            myConns = conns.Count  
            Console.WriteLine("The number of connections now is: {0}", myConns)  
        End Sub  
    End Class  
End Namespace  

Beispielausgabe:

The number of connections is: 2

The number of connections now is: 3

Hinweise

Der Wert, der für den connectionType Parameter in dieser Methode verwendet wird, ist der Wert, der in der ConnectionManagerType-Eigenschaft im Designer angezeigt wird. SQL Server (SSIS) enthält mehrere gängige Verbindungstypen, einschließlich der folgenden Verbindungs-Manager-Typen:

  • ADO für den Zugriff auf Microsoft ActiveX Data Objects (ADO)-Objekte

  • ADO.NET für den Zugriff auf ADO.NET Objekte

  • DATEI für den Zugriff auf Dateien

  • FLATFILE für den Zugriff auf Daten in flachen Dateien

  • HTTP für den Zugriff auf einen Webserver

  • OLEDB für den Zugriff auf relationale Datenquellen mithilfe von OLE DB

  • ODBC für den Zugriff auf Datenbanken mit ODBC

  • Windows-Verwaltungsinstrumentation (WMI) für den Zugriff auf einen Server und angeben des Umfangs der Verwaltung auf dem Server

  • FTP für den Zugriff auf einen Server zum Senden und Empfangen von Dateien

  • MSOLAP100 für den Zugriff auf eine Instanz von Microsoft SQL Server Analysis Services oder ein Analysis Services-Projekt

Weitere Informationen zu den gültigen Verbindungstypzeichenfolgen finden Sie unter Integration Services (SSIS) Connections.

Gilt für: