Implémentation d’une classe de connexion pour une extension de traitement des données

L’objet Connection représente une connexion de base de données ou une ressource similaire et constitue le point de départ pour les utilisateurs d’une extension de traitement des données SQL Server Reporting Services. Il représente les connexions aux serveurs de base de données, bien que toute entité ayant un comportement similaire puisse être exposée en tant que connexion.

Pour implémenter un objet Connection , créez une classe qui implémente et implémente IDbConnectionIDbConnectionExtensionéventuellement .

Dans votre implémentation, vous devez vous assurer qu’une connexion est créée et ouverte avant que les commandes puissent être exécutées. Assurez-vous que votre implémentation exige que les clients ouvrent et ferment explicitement les connexions, plutôt que d’ouvrir et de fermer implicitement vos connexions pour le client. Effectuez vos vérifications de sécurité lorsque la connexion est obtenue. L’exigence d’une connexion existante pour les autres classes de votre extension de traitement des données SSRS garantit ensuite que les vérifications de sécurité sont toujours effectuées lors de l’utilisation de votre source de données.

Les propriétés de la connexion souhaitée sont représentées sous forme de chaîne de connexion. Il est fortement recommandé que les extensions de traitement des données SSRS prennent en charge la ConnectionString propriété à l’aide du système de paire nom/valeur familier défini par OLE DB.

IDbConnection hérite de IExtension. Vous devez implémenter l’interface IExtension dans le cadre de votre implémentation de classe de connexion. L’interface IExtension permet à une classe d’implémenter un nom d’extension localisé et de traiter les informations de configuration spécifiques à l’extension stockées dans le fichier de configuration Reporting Services.

Votre objet Connection contient la LocalizedName propriété par le biais de son implémentation .IExtension Il est fortement recommandé que les extensions de traitement des données Reporting Services prennent en charge la LocalizedName propriété, afin que les utilisateurs rencontrent un nom familier et localisé pour l’extension dans une interface utilisateur, comme le Gestionnaire de rapports.

IExtension permet également à votre objet Connection de récupérer et de traiter les données de configuration personnalisées stockées dans le fichier RSReportServer.config. Pour plus d’informations sur le traitement des données de configuration personnalisées, consultez la SetConfiguration méthode.

La classe qui implémente IExtension n’est pas déchargée de la mémoire lorsque le reste de vos classes d’extension de traitement des données est déchargée. En raison de cela, vous pouvez utiliser votre classe d’extension pour stocker des informations d’état entre connexions ou pour stocker des données pouvant être mises en cache en mémoire. Votre classe d’extension reste en mémoire tant que le serveur de rapports est en cours d’exécution.

Vous pouvez étendre votre classe Connection pour inclure la prise en charge des informations d’identification dans Reporting Services en implémentant IDbConnectionExtension. Lorsque vous implémentez les propriétés et UserNamePassword les IntegratedSecuritypropriétés de l’interfaceIDbConnectionExtension, vous activez la case à cocher Sécurité intégrée et les zones de texte Nom d’utilisateur et Mot de passe de la boîte de dialogue Source de données dans le Concepteur de rapports. Cela permet au Concepteur de rapports de stocker et de récupérer des informations d’identification pour les sources de données qui prennent en charge l’authentification. Les informations d’identification sont stockées en toute sécurité et utilisées lors du rendu des rapports en mode préversion.

Voir aussi

Reporting Services Extensions
Mise en œuvre d’une extension pour le traitement des données
Bibliothèque d’extensions Reporting Services