Freigeben über


Implementieren der IDeliveryExtension-Schnittstelle für eine Übermittlungserweiterung

Mit der Klasse der Übermittlungserweiterungen können Sie ausgehend von den Inhalten der Benachrichtigungen Berichtsbenachrichtigungen an Benutzer übermitteln. Die Klasse der Übermittlungserweiterung bietet außerdem eine Infrastruktur zum Validieren der Benutzereinstellungen, die an die Übermittlungserweiterung übergeben werden. Ihre Übermittlungserweiterungsklasse sollte bestimmte Eigenschaften enthalten, die Clients verwenden können, um Informationen zum Namen der Erweiterung zu erhalten. Sie sollte auch über die Einstellungen verfügen, die die Erweiterung unterstützt, und die Renderingformate, die für die Übermittlungserweiterung verfügbar sind.

Screenshot of the IDeliveryExtension interface process.

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

Um eine Klasse der Übermittlungserweiterungen zu erstellen, implementieren Sie IDeliveryExtension und IExtension. Über die IDeliveryExtension-Schnittstelle kann die Übermittlungserweiterung Berichtsbenachrichtigungen mit der Deliver-Methode übermitteln und die eingehenden Erweiterungseinstellungen mit der ValidateUserData-Methode validieren. Durch die IExtension-Schnittstelle kann die Übermittlungserweiterung einen lokalisierten Erweiterungsnamen implementieren und erweiterungsspezifische Konfigurationsdaten verarbeiten, die in der SQL Server-Konfigurationsdatei gespeichert sind. Durch die Implementierung von IExtension enthält die Übermittlungserweiterung die Eigenschaft LocalizedName. SSRS-Übermittlungserweiterungen sollten die LocalizedName-Eigenschaft unterstützen, sodass Benutzer auf einen vertrauten Namen für die Erweiterung in einer Benutzeroberfläche stoßen, z. B. Berichts-Manager.

Die Übermittlungserweiterung muss auch die ExtensionSettings-Eigenschaft der IDeliveryExtension-Schnittstelle implementieren. Der Berichtsserver verwendet den von der ExtensionSettings-Eigenschaft zurückgegebenen Wert, um die für die Übermittlungserweiterung erforderlichen Einstellungen zu überprüfen. Clients, die mit den Übermittlungserweiterungen interagieren, verwenden die GetExtensionSettings-Methode des Berichtsserver-Webdiensts, um eine Liste der Einstellungen für die Übermittlungserweiterung zurückzugeben.

Sie können auch die Klasse der Übermittlungserweiterungen verwenden, um in der Datei RSReportServer.config gespeicherte, benutzerdefinierte Konfigurationsdaten abzurufen und zu verarbeiten. Weitere Informationen zur Verarbeitung benutzerdefinierter Konfigurationsdaten finden Sie in der Methode SetConfiguration.

Eine Beispielimplementierung der IDeliveryExtension-Klasse finden Sie unter Reporting Services Samples on CodePlex (SQL Server Reporting Services SSRS).For a sample IDeliveryExtension class implementation, see Reporting Services Samples on CodePlex (SQL Server Reporting Services SSRS).