Partager via


Implémentation de l'interface ISubscriptionBaseUIUserControl pour une extension de remise

Les extensions de remise Reporting Services peuvent contenir une implémentation d'une interface utilisateur d'abonnement pour rassembler des informations spécifiques à l'extension dans le Gestionnaire de rapports. L'interface utilisateur est appelée lorsqu'un utilisateur crée un abonnement ou en modifie un. Lorsqu'un nouvel abonnement est créé, l'interface utilisateur affiche des valeurs par défaut appropriées et active des utilisateurs pour interagir avec le fournisseur de remise. Lorsqu'un abonnement est modifié, l'interface utilisateur est pré-remplie avec les informations dans l'abonnement actuel.

Les extensions de remise fournissent l'interface utilisateur d'abonnement sous la forme d'un contrôle utilisateur ASP.NET. Le serveur de rapports incorpore le contrôle utilisateur défini par l'extension de remise lors de l'affichage de l'interface utilisateur d'abonnements. L'interface de base qui fournit des méthodes abstraites qui activent ces fonctionnalités est l'interface ISubscriptionBaseUIUserControl. Cette interface garantit que les opérations communes, telles que la validation des valeurs d'entrée, sont effectuées correctement. En outre, le contrôle utilisateur de base fournit un jeu de propriétés par défaut utilisées par le serveur de rapports pour veiller à la cohérence dans les abonnements. Ces propriétés sont requises par les extensions de remise intégrées au Gestionnaire de rapports.

Vous pouvez implémenter l'interface ISubscriptionBaseUIUserControl dans un fournisseur de remise pour générer une interface utilisateur d'abonnement pour le Gestionnaire de rapports. L'interface ISubscriptionBaseUIUserControl fournit l'infrastructure pour permettre aux utilisateurs d'entrer des valeurs pour les paramètres d'abonnement, pour traiter les paramètres dont a besoin l'extension de remise, et pour valider les paramètres.

[!REMARQUE]

Vous n'êtes pas obligé d'implémenter l'interface ISubscriptionBaseUIUserControl dans votre extension de remise. Les abonnements qui utilisent votre extension de remise peuvent toujours être créés à l'aide des méthodes de l'API SOAP CreateSubscription et CreateDataDrivenSubscription. Pour plus d'informations sur les fonctionnalités de l'API SOAP pour la gestion des abonnements et des remises, consultez Méthodes d'abonnement et de remise.

L'interface ISubscriptionBaseUIUserControl étend IExtension. Votre contrôle utilisateur qui implémente ISubscriptionBaseUIUserControl doit également hériter de System.Web.UI.WebControls.WebControl. Pour plus d'informations sur la classe WebControl, consultez votre Guide du développeur Microsoft .NET Framework.

Pour un exemple d'utilisation de l'interface ISubscriptionBaseUIUserControl, consultez SQL Server Reporting Services Product Samples (page éventuellement en anglais).