Implementazione dell'interfaccia IDeliveryExtension per un'estensione per il recapitoImplementing the IDeliveryExtension Interface for a Delivery Extension

La classe di estensioni per il recapito viene utilizzata per recapitare le notifiche dei report agli utenti in base al contenuto delle notifiche.Your delivery extension class is used to deliver report notifications to users based on the contents of the notifications. La classe di estensioni per il recapito fornisce anche l'infrastruttura per la convalida delle impostazioni utente passate all'estensione per il recapito.The delivery extension class also provides infrastructure for validating user settings that are passed to the delivery extension. Questa classe deve inoltre contenere proprietà specifiche che i client possono utilizzare per ottenere informazioni sul nome dell'estensione, sulle impostazioni supportate dall'estensione e sui formati di rendering disponibili per l'estensione per il recapito.In addition, your delivery extension class should contain specific properties that clients can use to gain information about the name of the extension, the settings that the extension supports, and the rendering formats that are available to the delivery extension.

Processo dell'interfaccia IDeliveryExtensionIDeliveryExtension interface process
L'interfaccia IDeliveryExtension consente la convalida dei dati utente e fornisce ai client informazioni sulle impostazioni di recapito necessarieThe IDeliveryExtension interface allows validation of user data as well as for clients to learn about the required delivery settings

Per creare un'estensione per il recapito, implementare IDeliveryExtension e IExtension.To create a delivery extension class, implement IDeliveryExtension and IExtension. L'interfaccia IDeliveryExtension consente all'estensione per il recapito di recapitare notifiche dei report tramite il metodo Deliver e di convalidare le impostazioni dell'estensione in ingresso tramite il metodo ValidateUserData.The IDeliveryExtension interface enables your delivery extension to deliver report notifications using the Deliver method and to validate incoming extension settings using the ValidateUserData method. L'interfaccia IExtension consente all'estensione per il recapito di implementare un nome di estensione localizzato e di elaborare le informazioni di configurazione specifiche dell'estensione archiviate nel file di configurazione di SQL ServerSQL Server.The IExtension interface enables your delivery extension to implement a localized extension name and to process extension-specific configuration information stored in the SQL ServerSQL Server configuration file. Grazie all'implementazione di IExtension, l'estensione per il recapito contiene la proprietà LocalizedName.By implementing IExtension, your delivery extension contains the LocalizedName property. È consigliabile che le estensioni per il recapito di SSRSSSRS supportino la proprietà LocalizedName, in modo che gli utenti possano visualizzare un nome familiare per l'estensione in un'interfaccia utente, ad esempio Gestione report.It is strongly recommended that SSRSSSRS delivery extensions support the LocalizedName property, so that users encounter a familiar name for the extension in a user interface, such as Report Manager.

L'estensione per il recapito deve implementare anche la proprietà ExtensionSettings dell'interfaccia IDeliveryExtension.Your delivery extension must also implement the ExtensionSettings property of the IDeliveryExtension interface. Il server di report utilizza il valore restituito dalla proprietà ExtensionSettings per valutare le impostazioni necessarie per un'estensione per il recapito.The report server uses the value returned by the ExtensionSettings property to evaluate the settings that a delivery extension requires. I client che interagiscono con le estensioni per il recapito utilizzano il metodo GetExtensionSettings del servizio Web ReportServer per restituire un elenco di impostazioni per l'estensione per il recapito.Clients that interact with delivery extensions use the GetExtensionSettings method of the Report Server Web service to return a list of settings for the delivery extension.

È inoltre possibile utilizzare la classe di estensioni per il recapito per recuperare ed elaborare i dati di configurazione personalizzati archiviati nel file RSReportServer.config.You can also use your delivery extension class to retrieve and process custom configuration data stored in the RSReportServer.config file. Per ulteriori informazioni sull'elaborazione dei dati di configurazione personalizzati, vedere il metodo SetConfiguration.For more information about processing custom configuration data, see the SetConfiguration method.

Per un'implementazione di esempio della classe IDeliveryExtension, vedere la pagina degli esempi del prodotto SQL Server Reporting Services.For a sample IDeliveryExtension class implementation, 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