Implementación de una clase de conexión para una extensión de procesamiento de datos

El objeto Connection representa una conexión de base de datos o un recurso similar y es el punto de partida para los usuarios de una extensión de procesamiento de datos de SQL Server Reporting Services. Representa las conexiones a los servidores de bases de datos, aunque cualquier entidad con un comportamiento similar se puede exponer como una conexión.

Para implementar un objeto Connection , cree una clase que implemente IDbConnection y, opcionalmente, implemente IDbConnectionExtension.

En la implementación, debe asegurarse de que se crea y se abre una conexión antes de que se puedan ejecutar los comandos. Asegúrese de que la implementación requiere que los clientes abran y cierren las conexiones explícitamente, en lugar de tener las conexiones abiertas y cerradas implícitamente para el cliente. Realice las comprobaciones de seguridad cuando se obtenga la conexión. Requerir una conexión existente para las otras clases de la extensión de procesamiento de datos de SSRS garantizará que las comprobaciones de seguridad siempre se realicen al trabajar con el origen de datos.

Las propiedades de la conexión deseada se representan como una cadena de conexión. Se recomienda encarecidamente que las extensiones de procesamiento de datos de SSRS admitan la ConnectionString propiedad mediante el conocido sistema de pares nombre-valor definido por OLE DB.

IDbConnection hereda de IExtension. Debe implementar la interfaz como parte de la IExtension implementación de la clase de conexión. La IExtension interfaz permite a una clase implementar un nombre de extensión localizado y procesar información de configuración específica de la extensión almacenada en el archivo de configuración de Reporting Services.

El objeto Connection contiene la LocalizedName propiedad a través de su implementación de IExtension. Se recomienda encarecidamente que las extensiones de procesamiento de datos de Reporting Services admitan la LocalizedName propiedad para que los usuarios encuentren un nombre conocido y localizado para la extensión en una interfaz de usuario, como el Administrador de informes.

IExtension también permite que el objeto Connection recupere y procese los datos de configuración personalizados almacenados en el archivo RSReportServer.config. Para obtener más información sobre el procesamiento de datos de configuración personalizados, consulte el SetConfiguration método .

La clase que implementa IExtension no se descarga de la memoria cuando se descarga el resto de las clases de extensión de procesamiento de datos. Por este motivo, puede usar la clase Extension para almacenar información de estado entre conexiones o para almacenar datos que se pueden almacenar en caché en la memoria. La clase Extension permanece en memoria siempre que se ejecute el servidor de informes.

Puede ampliar la clase Connection para incluir compatibilidad con credenciales en Reporting Services mediante la implementación IDbConnectionExtensionde . Cuando implemente las IntegratedSecuritypropiedades , UserNamey Password de la IDbConnectionExtension interfaz, habilite la casilla Seguridad integrada y los cuadros de texto Nombre de usuario y contraseña del cuadro de diálogo Origen de datos en el Diseñador de informes. Esto permite al Diseñador de informes almacenar y recuperar credenciales para orígenes de datos que admiten la autenticación. Las credenciales se almacenan de forma segura y se usan al representar informes en modo de vista previa.

Véase también

Extensiones de Reporting Services
Implementación de una extensión de procesamiento de datos
Biblioteca de extensiones de Reporting Services