Package.Connections Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Obtém a coleção de gerenciadores de conexões do pacote.

public:
 property Microsoft::SqlServer::Dts::Runtime::Connections ^ Connections { Microsoft::SqlServer::Dts::Runtime::Connections ^ get(); };

public Microsoft.SqlServer.Dts.Runtime.Connections Connections { get; }

member this.Connections : Microsoft.SqlServer.Dts.Runtime.Connections

Public ReadOnly Property Connections As Connections

Valor da propriedade

Connections

A coleção de gerenciadores de conexões do pacote.

Exemplos

O exemplo a seguir carrega o exemplo de pacote UsingExecuteProcess e recupera as conexões usadas pelo pacote e exibe algumas propriedades sobre as conexões.

static void Main(string[] args)  
        {  
            // The variable pkg points to the location  
            // of the ExecuteProcess package sample   
            // that is installed with the samples.  
            string pkg = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx";  

            Application app = new Application();  
            Package p = app.LoadPackage(pkg, null);  
            Connections conns = p.Connections;  
            foreach (ConnectionManager cm in conns)  
                Console.WriteLine("Name = " + cm.CreationName + ", HostType = " + cm.HostType);  
        }  

Shared  Sub Main(ByVal args() As String)  
            ' The variable pkg points to the location  
            ' of the ExecuteProcess package sample   
            ' that is installed with the samples.  
            Dim pkg As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx"   

            Dim app As Application =  New Application()   
            Dim p As Package =  app.LoadPackage(pkg,Nothing)   
            Dim conns As Connections =  p.Connections   
            Dim cm As ConnectionManager  
            For Each cm In conns  
                Console.WriteLine("Name = " + cm.CreationName + ", HostType = " + cm.HostType)  
            Next  
End Sub  

Saída de exemplo:

Name = FILE, HostType = ConnectionManager

Name = OLEDB, HostType = ConnectionManager

Name = OLEDB, HostType = ConnectionManager

Comentários

Os gerenciadores de conexões fornecem tarefas com uma interface genérica para o armazenamento de dados subjacente, permitindo uma implementação de tarefa mais simples. Use o AcquireConnection método do ConnectionManager objeto para recuperar as informações de conexão necessárias de qualquer um dos objetos do gerenciador de conexões na coleção.

O gerenciador de conexões pode ser referenciado por GUID ou pelo nome e você pode armazenar o nome do gerenciador de conexões em um arquivo de configuração. Para fazer referência à conexão por nome, use \Package.Connections[myConnection].ConnectionString, em vez de usar \Package.Connections[{9930DA64-A413-4286-9C66-74EDADB4F393}].ConnectionString.

Para obter mais informações sobre conexões e gerenciadores de conexões, consulte Conexões do SSIS (Integration Services).