Connections.Add Method (String)


Adds a ConnectionManager object of the specified connection type to the Connections collection.

Namespace:   Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

public ConnectionManager Add(
	string connectionType


Type: System.String

This parameter specifies the connection type. For example, the string "FILE" specifies a connection manager for files.

Return Value

Type: Microsoft.SqlServer.Dts.Runtime.ConnectionManager

The new ConnectionManager object that was added to the Connections collection.

The value used for the connectionType parameter in this method is the value that is shown in the ConnectionManagerType property in the Designer. SQL Server (SSIS) includes several common connection types, including the following connection manager types:

  • ADO for accessing Microsoft ActiveX Data Objects (ADO) objects

  • ADO.NET for accessing ADO.NET objects

  • FILE for accessing files

  • FLATFILE for accessing data in flat files

  • HTTP for accessing a Web server

  • OLEDB for accessing relational data sources using OLE DB

  • ODBC for accessing databases using ODBC

  • Windows Management Instrumentation (WMI) for accessing a server and specifying the scope of management on the server

  • FTP for accessing a server to send and receive files

  • MSOLAP100 for accessing an instance of Microsoft SQL Server Analysis Services or an Analysis Services project

For more information about the valid connection type strings, see Integration Services (SSIS) Connections.

The following code sample adds an ADO.NET connection manager to a package that contains two existing connections.

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.
            myConns = conns.Count;
            Console.WriteLine("The number of connections now is: {0}", myConns);

Sample Output:

The number of connections is: 2

The number of connections now is: 3

Return to top