Implementieren der IDeliveryExtension-Schnittstelle für eine Übermittlungserweiterung

Ihre Übermittlungserweiterungsklasse wird verwendet, um Berichtsbenachrichtigungen an Benutzer basierend auf dem Inhalt der Benachrichtigungen zu übermitteln. Die Übermittlungserweiterungsklasse stellt außerdem eine Infrastruktur für die Überprüfung von Benutzereinstellungen bereit, die an die Übermittlungserweiterung übergeben werden. Darüber hinaus sollte Ihre Übermittlungserweiterungsklasse bestimmte Eigenschaften enthalten, die Clients verwenden können, um Informationen über den Namen der Erweiterung, die Einstellungen, die die Erweiterung unterstützt, und die Renderingformate zu erhalten, die für die Übermittlungserweiterung verfügbar sind.

Die IDeliveryExtension-Schnittstelle ermöglicht die Validierung von Benutzerdaten sowie für Clients, um mehr über die erforderlichen Übermittlungseinstellungen zu erfahren.

Um eine Übermittlungserweiterungsklasse zu erstellen, implementieren IDeliveryExtension und IExtension. Die IDeliveryExtension-Schnittstelle ermöglicht es Ihrer Übermittlungserweiterung , Berichtsbenachrichtigungen mithilfe der Deliver Methode zu übermitteln und eingehende Erweiterungseinstellungen mithilfe der ValidateUserData Methode zu überprüfen. Die IExtension-Schnittstelle ermöglicht es Ihrer Übermittlungserweiterung , einen lokalisierten Erweiterungsnamen zu implementieren und erweiterungsspezifische Konfigurationsinformationen zu verarbeiten, die in der SQL Server-Konfigurationsdatei gespeichert sind. Durch die Implementierung von IExtension enthält Ihre Übermittlungserweiterung die LocalizedName Eigenschaft. Es wird dringend empfohlen, SSRS-Übermittlungserweiterungen die LocalizedName-Eigenschaft zu unterstützen, sodass Benutzer in einer Benutzeroberfläche auf einen vertrauten Namen für die Erweiterung stoßen, z. B. Berichts-Manager.

Ihre Übermittlungserweiterung muss auch die ExtensionSettings-Eigenschaft der IDeliveryExtension-Schnittstelle implementieren. Der Berichtsserver verwendet den von der ExtensionSettings Eigenschaft zurückgegebenen Wert, um die Einstellungen auszuwerten, die eine Übermittlungserweiterung erfordert. Clients, die mit Übermittlungserweiterungen interagieren, verwenden die GetExtensionSettings Methode des Report Server-Webdiensts, um eine Liste der Einstellungen für die Übermittlungserweiterung zurückzugeben.

Sie können ihre Übermittlungserweiterungsklasse auch verwenden, um benutzerdefinierte Konfigurationsdaten abzurufen und zu verarbeiten, die in der RSReportServer.config-Datei gespeichert sind. Weitere Informationen zum Verarbeiten von benutzerdefinierten Konfigurationsdaten finden Sie in der SetConfiguration Methode.

Eine Beispielimplementierung der IDeliveryExtension-Klasse finden Sie unter SQL Server Reporting Services-Produktbeispiele.

Siehe auch

Implementieren einer Übermittlungserweiterung
Erweiterungsbibliothek für Reporting Services