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. Il IDeliveryExtension interfaccia consente l'estensione per il recapito recapitare notifiche dei report utilizzando il Deliver (metodo) e per convalidare le impostazioni di estensione in ingresso tramite il ValidateUserData metodo.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. Il IExtension interfaccia consente l'estensione per il recapito di implementare un nome di estensione localizzato e di elaborare le informazioni di configurazione specifiche dell'estensione archiviate nel SQL ServerSQL Server file di configurazione.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. Implementando IExtension, contiene l'estensione per il recapito di LocalizedName proprietà.By implementing IExtension, your delivery extension contains the LocalizedName property. È consigliabile che SSRSSSRS supporto delle estensioni di recapito di LocalizedName proprietà, in modo che gli utenti riscontrano 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.

Estensione per il recapito deve implementare anche il ExtensionSettings proprietà del IDeliveryExtension interfaccia.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 esempio IDeliveryExtension implementazione della classe, vedere SQL Server Reporting Services Product Samples.For a sample IDeliveryExtension class implementation, see SQL Server Reporting Services Product Samples.

Vedere ancheSee Also

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