Crear un administrador de conexiones personalizado

Los pasos que debe seguir para crear un administrador de conexiones personalizado son similares a los pasos necesarios para crear cualquier otro objeto personalizado para Integration Services:

• Cree una clase nueva que herede de la clase base. Para un administrador de conexiones, la clase base es ConnectionManagerBase.

• Aplique el atributo que identifica el tipo de objeto para la clase. Para un administrador de conexiones, el atributo es DtsConnectionAttribute.

• Invalide la implementación de los métodos y las propiedades de la clase base. Para un administrador de conexiones, estos incluyen la propiedad ConnectionString y los métodos ReleaseConnection y AcquireConnection.

• Si lo desea, desarrolle una interfaz de usuario personalizada. Para un administrador de conexiones, esto requiere una clase que implemente la interfaz IDtsConnectionManagerUI.

[!NOTA]

Muchas de las tareas, orígenes y destinos que se han incluido en Integration Services se usan únicamente con tipos específicos de administradores de conexiones integrados. Por consiguiente, estos ejemplos no se pueden probar con las tareas y componentes integrados.

Introducción a un administrador de conexiones personalizado

Crear proyectos y clases

Dado que todos los administradores de conexiones administrados se derivan de la clase base ConnectionManagerBase, el primer paso para crear un administrador de conexiones personalizado consiste en crear un proyecto de bibliotecas de clases en el lenguaje de programación administrado que prefiera y, a continuación, crear una clase que herede de la clase base. En esta clase derivada se invalidarán los métodos y las propiedades de la clase base para implementar la funcionalidad personalizada.

En la misma solución, cree un segundo proyecto de bibliotecas de clases para la interfaz de usuario personalizada. Se recomienda usar un ensamblado independiente para la interfaz de usuario a fin de facilitar la implementación, ya que le permite actualizar y volver a implementar la tarea o su interfaz de usuario de forma independiente.

Configure ambos proyectos para firmar los ensamblados que se generarán en tiempo de compilación mediante un archivo de clave de nombre seguro.

Aplicar el atributo DtsConnection

Aplique el atributo DtsConnectionAttribute a la clase que ha creado para identificarlo como un administrador de conexiones. Este atributo proporciona información en tiempo de diseño, como el nombre, la descripción y el tipo de conexión del administrador de conexiones. Las propiedades Description y ConnectionType corresponden a las columnas Tipo y Descripción que se muestran en el cuadro de diálogo Agregar administrador de conexiones SSIS, que aparece al configurar las conexiones para un paquete en SQL Server Data Tools (SSDT).

Use la propiedad UITypeName para vincular el administrador de conexiones a su interfaz de usuario personalizada. Para obtener el token de clave pública necesario para esta propiedad, puede usar sn.exe -t con el fin de mostrar el token de clave pública del archivo de pares de claves (.snk) que desea usar para firmar el ensamblado de la interfaz de usuario.

<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
{
  . . .
}

Generar, implementar y depurar un administrador de conexiones personalizado

Los pasos para generar, implementar y depurar un administrador de conexiones personalizado en Integration Services son similares a los pasos necesarios en otros tipos de objetos personalizados. Para obtener más información, vea Generar, implementar y depurar objetos personalizados.

Manténgase al día con Integration Services Para obtener las descargas, los artículos, los ejemplos y los vídeos más recientes de Microsoft, así como las soluciones seleccionadas de la comunidad, visite la página de Integration Services en MSDN: Visite la página de Integration Services en MSDN Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.

Vea también

Tasks

Codificar un administrador de conexiones personalizado

Desarrollar una interfaz de usuario para un administrador de conexiones personalizado