Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Connection - Objekt stellt eine Datenbankverbindung oder ähnliche Ressource dar und ist der Ausgangspunkt für Benutzer einer SQL Server Reporting Services-Datenverarbeitungserweiterung. Sie stellt Verbindungen mit Datenbankservern dar, obwohl jede Entität mit ähnlichem Verhalten als Verbindung verfügbar gemacht werden kann.
Um ein Connection-Objekt zu implementieren, erstellen Sie eine Klasse, die IDbConnection optional implementiert und implementiert IDbConnectionExtension.
In Ihrer Implementierung müssen Sie sicherstellen, dass eine Verbindung erstellt und geöffnet wird, bevor Befehle ausgeführt werden können. Stellen Sie sicher, dass ihre Implementierung erfordert, dass Clients Verbindungen explizit öffnen und schließen müssen, anstatt dass Ihre Implementierung implizit verbindungen für den Client geöffnet und geschlossen wird. Führen Sie Ihre Sicherheitsüberprüfungen aus, wenn die Verbindung abgerufen wird. Wenn sie eine vorhandene Verbindung für die anderen Klassen in Ihrer SSRS-Datenverarbeitungserweiterung benötigen, stellen Sie dann sicher, dass sicherheitsrelevante Prüfungen immer ausgeführt werden, wenn Sie mit Ihrer Datenquelle arbeiten.
Die Eigenschaften der gewünschten Verbindung werden als Verbindungszeichenfolge dargestellt. Es wird dringend empfohlen, dass SSRS-Datenverarbeitungserweiterungen die ConnectionString Eigenschaft mithilfe des vertrauten Namens-Wert-Paarsystems unterstützen, das von OLE DB definiert wird.
Hinweis
Verbindungsobjekte sind häufig ressourcenintensiv zu erhalten, daher sollten Sie die Poolverbindungen oder andere Techniken in Betracht ziehen, um dies zu vermeiden.
IDbConnection erbt von IExtension. Sie müssen die IExtension Schnittstelle als Teil der Verbindungsklassenimplementierung implementieren. Die IExtension Schnittstelle ermöglicht es einer Klasse, einen lokalisierten Erweiterungsnamen zu implementieren und erweiterungsspezifische Konfigurationsinformationen zu verarbeiten, die in der Reporting Services-Konfigurationsdatei gespeichert sind.
Ihr Connection - Objekt enthält die LocalizedName Eigenschaft über die Implementierung von IExtension. Es wird dringend empfohlen, dass Reporting Services-Datenverarbeitungserweiterungen die LocalizedName Eigenschaft unterstützen, sodass Benutzer auf einen vertrauten, lokalisierten Namen für die Erweiterung in einer Benutzeroberfläche stoßen, z. B. Berichts-Manager.
IExtension Ermöglicht dem Connection-Objekt auch das Abrufen und Verarbeiten von benutzerdefinierten Konfigurationsdaten, die in der RSReportServer.config Datei gespeichert sind. Weitere Informationen zum Verarbeiten von benutzerdefinierten Konfigurationsdaten finden Sie in der SetConfiguration Methode.
Die implementierte Klasse wird nicht aus dem Arbeitsspeicher entladen, wenn die restlichen Datenverarbeitungserweiterungsklassen IExtension entladen werden. Aus diesem Gründen können Sie ihre Erweiterungsklasse verwenden, um Verbindungsübergreifende Statusinformationen zu speichern oder Um Daten zu speichern, die im Arbeitsspeicher zwischengespeichert werden können. Die Erweiterungsklasse bleibt im Arbeitsspeicher, solange der Berichtsserver ausgeführt wird.
Sie können Ihre Connection-Klasse erweitern, um unterstützung für Anmeldeinformationen in Reporting Services einzuschließen, indem Sie die Implementierung .IDbConnectionExtension Wenn Sie die IntegratedSecurityUserNameEigenschaften und Password Eigenschaften der IDbConnectionExtension Schnittstelle implementieren, aktivieren Sie das Kontrollkästchen "Integrierte Sicherheit" und "Benutzername" und "Kennwort" des Dialogfelds "Datenquelle" im Berichts-Designer. Auf diese Weise kann der Berichts-Designer Anmeldeinformationen für Datenquellen speichern und abrufen, die die Authentifizierung unterstützen. Die Anmeldeinformationen werden sicher gespeichert und beim Rendern von Berichten im Vorschaumodus verwendet.
Hinweis
Die implizite Implementierung IDbConnectionExtension erfordert, dass Sie die Member und IDbConnectionIExtension Schnittstellen implementieren.
Eine Beispielimplementierung der Connection-Klasse finden Sie unter SQL Server Reporting Services-Produktbeispiele.
Siehe auch
Reporting Services-Erweiterungen
Implementing a Data Processing Extension (Implementieren von Datenverarbeitungserweiterungen)
Erweiterungsbibliothek für Reporting Services