Condividi tramite


Implementazione dell'interfaccia ISubscriptionBaseUIUserControl per un'estensione per il recapito

Le estensioni per il recapito di Reporting Services possono contenere un'implementazione di un'interfaccia utente di sottoscrizione per la raccolta di informazioni specifiche dell'estensione in Gestione report. L'interfaccia utente viene richiamata quando un utente crea una nuova sottoscrizione o ne modifica una esistente. 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. Quando una sottoscrizione viene modificata, l'interfaccia utente viene prepopolata con le informazioni nella sottoscrizione corrente.

Le estensioni per il recapito forniscono un'interfaccia utente di sottoscrizione come controllo utente ASP.NET. Il server di report incorpora il controllo utente definito dall'estensione per il recapito quando viene visualizzata l'interfaccia utente di sottoscrizione. L'interfaccia di base che fornisce i metodi astratti che consentono di abilitare questa funzionalità è l'interfaccia ISubscriptionBaseUIUserControl. Questa interfaccia garantisce che le operazioni comuni, ad esempio la convalida di valori di input, vengano eseguite correttamente. Il controllo utente di base fornisce inoltre un set di proprietà predefinite utilizzate dal server di report per garantire coerenza tra le sottoscrizioni. Queste proprietà sono richieste dalle estensioni per il recapito integrate in Gestione report.

È possibile implementare l'interfaccia ISubscriptionBaseUIUserControl in un provider di recapito per generare l'interfaccia utente di sottoscrizione per Gestione report. 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.

[!NOTA]

Non è necessario implementare l'interfaccia ISubscriptionBaseUIUserControl come parte dell'estensione per il recapito. Le sottoscrizioni che utilizzano l'estensione per il recapito possono invece essere sempre create tramite i metodi dell'API SOAP CreateSubscription e CreateDataDrivenSubscription. Per ulteriori informazioni sulle funzionalità dell'API SOAP per la gestione della sottoscrizione e del recapito, vedere Metodi di sottoscrizione e recapito.

L'interfaccia ISubscriptionBaseUIUserControl estende IExtension. Il controllo utente che implementa ISubscriptionBaseUIUserControl deve inoltre ereditare da System.Web.UI.WebControls.WebControl. Per ulteriori informazioni sulla classe WebControl, vedere la Guida per gli sviluppatori di Microsoft.NET Framework.

Per un esempio di utilizzo dell'interfaccia di ISubscriptionBaseUIUserControl, vedere la pagina relativa agli esempi del prodotto per SQL Server Reporting Services.