Connections.Add(String) Método

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

Parâmetros

Retornos

O novo ConnectionManager objeto que foi adicionado à Connections coleção.

Exemplos

O exemplo de código a seguir adiciona um gerenciador de conexões ADO.NET a um pacote que contém duas conexões existentes.

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  

Amostra de saída:

The number of connections is: 2

The number of connections now is: 3

Comentários

O valor usado para o connectionType parâmetro neste método é o valor mostrado na propriedade ConnectionManagerType no Designer. SQL Server (SSIS) inclui vários tipos comuns de conexão, incluindo os seguintes tipos de gerenciador de conexão:

• ADO para acessar objetos Microsoft ActiveX Data Objects (ADO)

• ADO.NET para acessar objetos ADO.NET

• FILE para acessar arquivos

• FLATFILE para acessar dados em arquivos planos

• HTTP para acessar um servidor Web

• OLEDB para acessar fontes de dados relacionais usando OLE DB

• ODBC para acesso a bancos de dados usando ODBC

• Instrumentação de Gerenciamento do Windows (WMI) para acessar um servidor e especificar o escopo de gerenciamento no servidor

• FTP para acessar um servidor para enviar e receber arquivos

• MSOLAP100 para acessar uma instância do Microsoft SQL Server Analysis Services ou um projeto de Serviços de Análise

Para mais informações sobre as strings de tipos de conexão válidas, veja Conexões de Serviços de Integração (SSIS).