Compartir a través de

  • Artículo

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. En un administrador de conexiones, esto requiere una clase que implemente la interfaz IDtsConnectionManagerUI.

Para obtener ejemplos de administradores de conexiones personalizados, vea los ejemplos de Integration Services en Codeplex. Los ejemplos de código mostrados en este tema se deducen del ejemplo de administrador de conexiones personalizado de Sql Server.

[!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 clase 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 clase 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 Business Intelligence Development Studio.

Use la propiedad UITypeName para vincular el administrador de conexiones a su interfaz de usuario personalizada. Para obtener el token de clave pública requerido para esta propiedad, puede utilizar sn.exe -t a fin de mostrar el token de clave pública del archivo de pares de claves (.snk) que desea utilizar 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.

Icono de Integration Services (pequeño) 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 soluciones seleccionadas de la comunidad, visite la página de Integration Services en MSDN o TechNet:

Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.

Historial de cambios

Contenido actualizado

  • Se ha agregado una nota que explica por qué los ejemplos personalizados no se pueden probar con las tareas y componentes integrados en Integration Services.