Conectando-se a fontes de dados no componente de Script

Um gerenciador de conexões é uma unidade conveniente que encapsula e armazena as informações necessárias para conexão com uma fonte de dados de um tipo específico. Para obter mais informações, consulte Conexões do Integration Services.

Você pode tornar os gerenciadores de conexões existentes disponíveis para acesso por meio de script personalizado no componente de origem ou destino, clicando nos botões Adicionar e Remover na página Gerenciadores de Conexões do Editor de Transformação de Script. Entretanto, você deverá gravar seu próprio código personalizado para carregar ou salvar seus dados e, possivelmente, abrir e fechar a conexão com a fonte de dados. Para obter mais informações sobre a página Gerenciadores de Conexões do Editor de Transformação de Script, consulte Configurando o componente Script no Editor de Componentes de Script e Editor de Transformação Scripts (página Gerenciadores de Conexões).

O componente de Script cria uma classe de coleção Connections no item do projeto ComponentWrapper que contém um acessador com rigidez de tipos para cada gerenciador de conexões que tem o mesmo nome que o gerenciador de conexões em si. Esta coleção é exposta pela propriedade Connections da classe ScriptMain. A propriedade de acessador retorna uma referência ao gerenciador de conexões como uma instância de IDTSConnectionManager100. Por exemplo, se você adicionou um gerenciador de conexões nomeado MyADONETConnection na página Gerenciadores de Conexões da caixa de diálogo, poderá obter uma referência a ele em seu script adicionando o seguinte código:

Dim myADONETConnectionManager As IDTSConnectionManager100 = _

Me.Connections.MyADONETConnection

Observação
Você deve saber o tipo de conexão retornado pelo gerenciador de conexões antes de chamar AcquireConnection. Como a tarefa Script tem Option Strict habilitada, você deve converter a conexão, que é retornada como tipo Object, para o tipo de conexão adequado antes de poder usá-lo.

Em seguida, chame o método AcquireConnection do gerenciador de conexões específico para obter a conexão subjacente ou as informações necessárias para se conectar à fonte de dados. Por exemplo, você obtém uma referência ao System.Data.SqlConnection quebrada por um gerenciador de conexões do ADO.NET usando o código seguinte:

Dim myADOConnection As SqlConnection = _

CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)

Em contraste, a mesma chamada para um gerenciador de conexões de arquivo simples retorna somente o caminho e nome de arquivo da fonte de dados de arquivo.

Dim myFlatFile As String = _

CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)

Em seguida, forneça esse caminho e nome de arquivo a um System.IO.StreamReader ou Streamwriter para ler ou gravar os dados no arquivo simples.

Importante

Quando você grava um código gerenciado em um componente de Script, não pode chamar o método de gerenciadores de conexões AcquireConnection que retorna objetos não gerenciados, como o gerenciador de conexões OLE DB e o gerenciador de conexões do Excel. Entretanto, você pode gravar a propriedade ConnectionString desses gerenciadores de conexões e se conectar à fonte de dados diretamente em seu código utilizando a cadeia de conexões de um OLEDB connection no namespace System.Data.OleDb. Se você precisar chamar o método AcquireConnection de um gerenciador de conexões que retorna um objeto não gerenciado, use um gerenciador de conexões ADO.NET. Quando você configurar o gerenciador de conexões ADO.NET para usar um provedor OLE DB, ele se conectará usando o provedor de dados .NET Framework para OLE DB. Neste caso, o método AcquireConnection retorna um System.Data.OleDb.OleDbConnection em vez de um objeto não gerenciado. Para configurar um gerenciador de conexões ADO.NET para uso com uma fonte de dados Excel, selecione o Microsoft OLE DB Provider for Jet, especifique uma pasta de trabalho do Excel e, em seguida, insira Excel 8.0 (para o Excel 97 e versões posteriores) como o valor de Propriedades Estendidas na página Todos da caixa de diálogo Gerenciador de Conexões.

Para obter mais informações sobre como usar gerenciadores de conexões com o componente de script, consulte Criando uma fonte com o componente Script e Criando um destino com o componente Script.