Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: 
SQL Server SSIS Integration Runtime em Azure Data Factory
Um gestor de ligação é uma unidade conveniente que encapsula e armazena a informação necessária para se ligar a uma fonte de dados de um determinado tipo. Para obter mais informações, consulte Ligações do Integration Services (SSIS).
Pode disponibilizar gestores de conexões existentes através do script personalizado no componente de origem ou destino, clicando nos botões Adicionar e Remover na página de Gestores de Ligação do Editor de Transformação de Scripts. No entanto, deve escrever o seu próprio código personalizado para carregar ou guardar os seus dados, e possivelmente para abrir e fechar a ligação à fonte de dados. Para mais informações sobre a página de Gestores de Ligação do Editor de Transformação de Scripts, consulte Configurar o Componente de Scripts no Editor de Componentes de Scripts e no Editor de Transformação de Scripts (Página de Gestores de Ligações).
O componente Script cria uma classe de coleção Connections no item do projeto ComponentWrapper que contém um acessor fortemente tipado para cada gestor de conexões, com o mesmo nome do próprio gestor de conexões. Esta coleção é exposta através da propriedade Connections da classe ScriptMain . A propriedade do acessório devolve uma referência ao gestor de ligações como uma instância de IDTSConnectionManager100. Por exemplo, se adicionou um gestor de conexões chamado MyADONETConnection na página de Gerentes de Ligação da caixa de diálogo, pode obter uma referência a ele no seu script adicionando o seguinte código:
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Note
Deve saber o tipo de ligação que é devolvida pelo gestor de ligações antes de ligar para a AcquireConnection. Como a tarefa Script tem o Option Strict ativado, tens de lançar a ligação, que é devolvida como Type Object, para o tipo de ligação apropriado antes de a poderes usar.
De seguida, chama o método AcquireConnection do gestor de ligação específico para obter ou a ligação subjacente ou a informação necessária para se ligar à fonte de dados. Por exemplo, obtém uma referência ao System.Data.SqlConnection envolta por um gestor de ligação ADO.NET usando o seguinte código:
Dim myADOConnection As SqlConnection = _
CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)
Em contraste, a mesma chamada para um gestor de ligação de ficheiros plano devolve apenas o caminho e o nome do ficheiro da fonte de dados do ficheiro.
Dim myFlatFile As String = _
CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)
Deve então fornecer este caminho e nome do ficheiro a um System.IO.StreamReader ou Streamwriter para ler ou escrever os dados no ficheiro plano.
Importante
Quando escreve código gerido num componente Script, não pode chamar o método AcquireConnection dos gestores de conexões que retornam objetos não geridos, como o gestor de conexões OLE DB e o gestor de conexões Excel. No entanto, pode ler a propriedade ConnectionString destes gestores de ligação e ligar-se diretamente à fonte de dados no seu código usando a cadeia de ligação de uma ligação OLEDB do namespace System.Data.OleDb.
Se precisar de chamar o método AcquireConnection de um gestor de ligações que devolve um objeto não gerido, use um gestor de conexões ADO.NET. Quando configura o gestor de conexões ADO.NET para usar um fornecedor OLE DB, ele liga-se usando o .NET Framework Data Provider para OLE DB. Neste caso, o método AcquireConnection devolve um System.Data.OleDb.OleDbConnection em vez de um objeto não gerido. Para configurar um ADO.NET connection manager para uso com uma fonte de dados Excel, selecione o Microsoft Provedor OLE DB para Jet, especifique um livro de trabalho Excel e depois insira Excel 8.0 (para Excel 97 e posteriores) como o valor de Propriedades Estendidas na página Tudo do Caixa de diálogo Gestor de Ligações.
Para mais informações sobre como usar gestores de ligação com o componente script, consulte Criação de uma Fonte com o Componente Script e Criação de um Destino com o Componente Script.