Connections.Add(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um objeto ConnectionManager do tipo de conexão especificado à coleção 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
Esse parâmetro especifica o tipo de conexão. Por exemplo, a cadeia de caracteres "FILE" especifica um gerenciador de conexões para arquivos.
Retornos
O novo objeto ConnectionManager que foi adicionado à coleção Connections.
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
Saída de exemplo:
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 de conexão comuns, incluindo os seguintes tipos de gerenciador de conexões:
ADO para acessar objetos do Microsoft ActiveX Data Objects (ADO)
ADO.NET para acessar objetos ADO.NET
ARQUIVO para acessar arquivos
FLATFILE para acessar dados em arquivos simples
HTTP para acessar um servidor Web
OLEDB para acessar fontes de dados relacionais usando o OLE DB
ODBC para acessar bancos de dados usando ODBC
WMI (Instrumentação de Gerenciamento do Windows) 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 do Analysis Services
Para obter mais informações sobre as cadeias de conexão válidas, consulte Conexões do SSIS (Integration Services).