Artigo
09/28/2010

Criando um gerenciador de conexões personalizado

As etapas a seguir para criar um gerenciador de conexões personalizado são semelhantes às etapas de criação de qualquer outro objeto personalizado para o Integration Services:

Crie uma classe nova herdada da classe base. Para um gerenciador de conexões, a classe base é ConnectionManagerBase.
Aplique o atributo que identifica o tipo de objeto para a classe. Para um gerenciador de conexões, o atributo é DtsConnectionAttribute.
Substitua a implementação dos métodos e propriedades da classe base. Para um gerenciador de conexões, eles incluem a propriedade ConnectionString e os métodos AcquireConnection e ReleaseConnection.
Opcionalmente, desenvolva uma interface de usuário personalizada. Para um gerenciador de conexões, isso requer uma classe que implemente a interface IDtsConnectionManagerUI.

Para obter exemplos de gerenciadores de conexões personalizados, consulte os exemplos do Integration Services no Codeplex. Os exemplos de código mostrados neste tópico foram extraídos do exemplo de gerenciador de conexões personalizado do SQL Server.

Observação
A maioria das tarefas, fontes e destinos incluídos no Integration Services funcionam somente com tipos específicos de gerenciadores de conexões internos. Portanto, esses exemplos não podem ser testados com as tarefas e componentes internos.

Guia de Introdução com um gerenciador de conexões personalizado

Criando projetos e classes

Como todos os gerenciadores de conexões gerenciados derivam da classe base ConnectionManagerBase, o primeiro passo para criar um gerenciador de conexões personalizado é criar um projeto de biblioteca de classes na linguagem de programação gerenciada de sua preferência e criar uma classe herdada da classe base. Nessa classe derivada, você substituirá os métodos e propriedades da classe base para implementar sua funcionalidade personalizada.

Na mesma solução, crie um segundo projeto de biblioteca de classe para a interface de usuário personalizada. Recomenda-se um assembly separado para a interface do usuário para facilitar a implantação, pois ela permite que você atualize e implemente de novo o gerenciador de conexões ou sua interface do usuário de forma independente.

Configure ambos os projetos para atribuir os assemblies que serão gerados no momento de compilação usando um arquivo de chave de nome forte.

Aplicando o atributo DtsConnection

Aplique o atributo DtsConnectionAttribute à classe que você criou para identificá-la como um gerenciador de conexões. Esse atributo fornece informações de tempo de design como o nome, a descrição e o tipo de conexão do gerenciador de conexões. As propriedades ConnectionType e Description correspondem às colunas Tipo e Descrição exibidas na caixa de diálogo Adicionar Gerenciador de Conexões SSIS, exibida ao configurar conexões para um pacote no Business Intelligence Development Studio.

Use a propriedade UITypeName para vincular o gerenciador de conexões à sua interface do usuário personalizada. Para obter o token de chave pública requerido para essa propriedade, você pode usar o sn.exe -t para exibir o token de chave pública a partir do arquivo de par de chaves (.snk) a ser usado para atribuir o assembly de interface do usuário.

<DtsConnection(ConnectionType:="SQLVB", _
  DisplayName:="SqlConnectionManager (VB)", _
  Description:="Connection manager for Sql Server", _
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _
Public Class SqlConnMgrVB
  Inherits ConnectionManagerBase
  . . .
End Class

[DtsConnection(ConnectionType = "SQLCS",
  DisplayName = "SqlConnectionManager (CS)",
  Description = "Connection manager for Sql Server",
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]
public class SqlConnMgrCS :
ConnectionManagerBase
{
  . . .
}

Compilando, implantando e depurando um gerenciador de conexões personalizado

As etapas para compilar, implantar e depurar um gerenciador de conexões personalizado no Integration Services são semelhantes às etapas para outros tipos de objetos personalizados. Para obter mais informações, consulte Compilando, implantando e depurando objetos personalizados.

Fique atualizado com o Integration Services

Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN ou TechNet:

Para receber uma notificação automática sobre estas atualizações, assine os RSS feeds disponíveis na página.

Consulte também

Tarefas

Codificando um gerenciador de conexões personalizado

Desenvolvendo uma interface do usuário para um gerenciador de conexões personalizado

Histórico de alterações

Conteúdo atualizado
Uma observação que explica por que os exemplos personalizados não podem ser testados com tarefas e componentes internos no Integration Services foi adicionada.

Partilhar via