Implementazione dell'interfaccia ISubscriptionBaseUIUserControlImplementing the ISubscriptionBaseUIUserControl Interface

Le estensioni per il recapito di Reporting ServicesReporting Services possono contenere un'implementazione di un'interfaccia utente di sottoscrizione per la raccolta di informazioni specifiche dell'estensione in Gestione report. Reporting ServicesReporting Services delivery extensions can contain an implementation of a subscription user interface (UI) for gathering extension-specific information in Report Manager. L'interfaccia utente viene richiamata quando un utente crea una nuova sottoscrizione o ne modifica una esistente.The UI is invoked when a user creates a new subscription or modifies an existing one. Quando viene creata una nuova sottoscrizione, nell'interfaccia utente vengono visualizzati i valori predefiniti appropriati e gli utenti possono interagire con il provider di recapito.When a new subscription is being created, the UI displays suitable default values and enables users to interact with the delivery provider. Quando una sottoscrizione viene modificata, l'interfaccia utente viene prepopolata con le informazioni nella sottoscrizione corrente.When a subscription is being modified, the UI is pre-populated with the information in the current subscription.

Le estensioni per il recapito forniscono un'interfaccia utente di sottoscrizione come controllo utente ASP.NET.Delivery extensions provide subscription UI as an ASP.NET user control. Il server di report incorpora il controllo utente definito dall'estensione per il recapito quando viene visualizzata l'interfaccia utente di sottoscrizione.The report server incorporates the user control defined by the delivery extension when displaying the subscriptions UI. L'interfaccia di base che fornisce i metodi astratti che consentono di abilitare questa funzionalità è l'interfaccia ISubscriptionBaseUIUserControl.The base interface that provides abstract methods enabling this functionality is the ISubscriptionBaseUIUserControl interface. Questa interfaccia garantisce che le operazioni comuni, ad esempio la convalida di valori di input, vengano eseguite correttamente.This interface ensures that common operations, such as validation of input values, are correctly performed. Il controllo utente di base fornisce inoltre un set di proprietà predefinite utilizzate dal server di report per garantire coerenza tra le sottoscrizioni.Additionally, the base user control supplies a set of default properties that are used by the report server for consistency across subscriptions. Queste proprietà sono richieste dalle estensioni per il recapito integrate in Gestione report.These properties are required by delivery extensions that are integrated with Report Manager.

È possibile implementare l'interfaccia ISubscriptionBaseUIUserControl in un provider di recapito per compilare l'interfaccia utente di sottoscrizione per Gestione report.You can implement the ISubscriptionBaseUIUserControl interface in a delivery provider in order to build a subscription UI for Report Manager. L'interfaccia ISubscriptionBaseUIUserControl fornisce l'infrastruttura per consentire agli utenti di immettere i valori per le impostazioni di sottoscrizione, per l'elaborazione delle impostazioni necessarie per l'estensione per il recapito e per la convalida delle impostazioni.The ISubscriptionBaseUIUserControl interface provides infrastructure for enabling users to enter values for subscription settings, for processing the settings needed for the delivery extension, and for validating the settings.

Nota

Non è necessario implementare l'interfaccia ISubscriptionBaseUIUserControl come parte dell'estensione per il recapito.You are not required to implement the ISubscriptionBaseUIUserControl interface as part of your delivery extension. Le sottoscrizioni che utilizzano l'estensione per il recapito possono invece essere sempre create tramite i metodi dell'API SOAP CreateSubscription e CreateDataDrivenSubscription.Subscriptions that use your delivery extension can always be created through the SOAP API methods CreateSubscription and CreateDataDrivenSubscription instead. Per altre informazioni sulle caratteristiche dell'API SOAP per la gestione della sottoscrizione e del recapito, vedere Metodi di sottoscrizione e recapito.For more information about the SOAP API features for managing subscription and delivery, see Subscription and Delivery Methods.

L'interfaccia ISubscriptionBaseUIUserControl estende IExtension.The ISubscriptionBaseUIUserControl interface extends IExtension. Il controllo utente che implementa ISubscriptionBaseUIUserControl deve anche ereditare da System.Web.UI.WebControls.WebControl.Your user control that implements ISubscriptionBaseUIUserControl must also inherit from System.Web.UI.WebControls.WebControl. Per altre informazioni sulla classe WebControl, vedere la Guida per gli sviluppatori di MicrosoftMicrosoft .NET Framework.NET Framework.For more information about the WebControl class, see your MicrosoftMicrosoft .NET Framework.NET Framework Developer's Guide.

Per un esempio di uso dell'interfaccia di ISubscriptionBaseUIUserControl, vedere la pagina degli esempi del prodotto SQL Server Reporting Services.For an example of how to use the ISubscriptionBaseUIUserControl interface, see SQL Server Reporting Services Product Samples.

Vedere ancheSee Also

Implementazione di un'estensione per il recapito Implementing a Delivery Extension
Libreria di estensioni di Reporting ServicesReporting Services Extension Library