Lernprogramm: Anmeldung bei einer sicheren SQL Server-Datenbank unter Verwendung von SQL-Authentifizierung

Einführung

Zur Anmeldung bei einer sicheren SQL Server-Datenbank verwenden Sie Klassen aus dem ReportDocument-Objektmodell.

Das ReportDocument-Objekt verfügt über eine Database-Eigenschaft, die eine Database-Instanz zurückgibt. Diese Database-Instanz enthält die Datenbankinformationen für den Bericht, darunter eine Tables-Eigenschaft, die eine Instanz der Tables-Indexklasse zurückgibt. Anschließend können einzelne Table-Instanzen aus der Tables-Indexklasse abgerufen werden.

Die Anmeldung findet auf der Detailebene jeder Table-Instanz statt, der ein individuelles Zugriffsrecht für den sicheren SQL Server zugewiesen werden muss. Zu diesem Zweck werden Anmeldeinformationen in eine ConnectionInfo-Instanz eingefügt, und die ConnectionInfo-Instanz wird dann innerhalb einer for-Schleife auf die ConnectionInfo-Eigenschaft jeder Table-Instanz angewendet.

Die Eigenschaften der ConnectionInfo-Klasse umfassen:

  • ServerName
  • DatabaseName
  • UserID
  • Password
  • IntegratedSecurity (in diesem Lernprogramm nicht verwendet)
NoteAnmerkung

Wenn Sie ein Lernprogramm ausführen möchten, in dem die Windows-Authentifizierung (und daher die IntegratedSecurity-Eigenschaft und nicht die Eigenschaften UserID und Password) verwendet wird, informieren Sie sich unter Lernprogramm: Anmeldung bei einer sicheren SQL Server-Datenbank unter Verwendung integrierter Sicherheit.

Wenn nur die Eigenschaften DatabaseName, UserID und Password festgelegt werden sollen, werden Sie beim Standardserver und bei der Datenbank angemeldet, die im Bericht angegeben sind. Wenn Sie jedoch eine andere ServerName-Eigenschaft zuweisen möchten, können Sie den Bericht zur Laufzeit an einen anderen Server umleiten.

Zunächst erstellen Sie einen Bericht, der Daten aus einer sicheren SQL Server-Datenbank enthält.

Sie können dieses Lernprogramm zwar auch mit Klassen des CrystalReportViewer-Objektmodells bearbeiten, dem ReportDocument-Objektmodell sollte jedoch der Vorzug gegeben werden. Weitere Informationen zur Verwendung des geeigneten Objekts finden Sie unter Welches Objektmodell sollte verwendet werden?

Um dieses Lernprogramm mit dem CrystalReportViewer-Objektmodell zu erstellen, informieren Sie sich unter Lernprogramm: Anmeldung bei einer sicheren SQL Server-Datenbank in den CrystalReportViewer-Lernprogrammen.

Beispielcode

Dieses Lernprogramm enthält Beispielcode, der sowohl in C# als auch in Visual Basic geschrieben wurde und die fertige Projektversion darstellt. Befolgen Sie die Anweisungen in diesem Lernprogramm, um ein neues Projekt zu erstellen. Sie können aber auch das Beispielcodeprojekt öffnen, wenn Sie mit einer fertigen Version arbeiten möchten.

Die Beispielcodes wurden in Ordnern gespeichert, die nach Sprache und Projekttyp kategorisiert wurden. Die Ordnernamen für jede Beispielcodeversion lauten wie folgt:

  • C#-Website: CS_Web_RDObjMod_DBLogon
  • C#-Windows-Projekt: CS_Win_RDObjMod_DBLogon
  • Visual Basic-Website: VB_Web_RDObjMod_DBLogon
  • Visual Basic-Windows-Projekt: VB_Win_RDObjMod_DBLogon

Nähere Angaben zum Speicherort der Ordner mit diesen Beispielen finden Sie unter Verzeichnis mit Beispielcode für Lernprogramme.

In diesem Abschnitt