Connections.Add(String) Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Agrega un objeto ConnectionManager del tipo de conexión especificado a la colección Connections.

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

connectionType

String

Este parámetro especifica el tipo de conexión. Por ejemplo, la cadena "FILE" especifica un administrador de conexiones para archivos.

Devoluciones

ConnectionManager

El objeto nuevo ConnectionManager que se ha agregado a la colección Connections.

Ejemplos

En el ejemplo de código siguiente se agrega un administrador de conexiones ADO.NET a un paquete que contiene dos conexiones 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  

Salida del ejemplo:

The number of connections is: 2

The number of connections now is: 3

Comentarios

El valor utilizado para el connectionType parámetro en este método es el valor que se muestra en la propiedad ConnectionManagerType en el Diseñador. SQL Server (SSIS) incluye varios tipos de conexión comunes, incluidos los siguientes tipos de administrador de conexiones:

• ADO para acceder a objetos de microsoft ActiveX Data Objects (ADO)

• ADO.NET para acceder a objetos de ADO.NET

• ARCHIVO para acceder a archivos

• FLATFILE para acceder a datos en archivos planos

• HTTP para acceder a un servidor web

• OLEDB para acceder a orígenes de datos relacionales mediante OLE DB

• ODBC para acceder a bases de datos mediante ODBC

• Instrumental de administración de Windows (WMI) para acceder a un servidor y especificar el ámbito de administración en el servidor

• FTP para acceder a un servidor para enviar y recibir archivos

• MSOLAP100 para acceder a una instancia de Microsoft SQL Server Analysis Services o un proyecto de Analysis Services

Para obtener más información sobre las cadenas de tipo de conexión válidas, vea Conexiones de Integration Services (SSIS).