CrystalReportViewer-Objektmodell

Die CrystalReportViewer-Klasse erfüllt zwei Funktionen:

  • Im Web Form oder Windows Form wird CrystalReportViewer als .NET-Steuerelement verfügbar gemacht, das dem Formular für die Berichtanzeige hinzugefügt werden kann. Spezifische Informationen über seine Funktion als .NET-Steuerelement finden Sie unter Report Viewer-Steuerelemente.
  • In der zugrunde liegenden CodeBehind-Klasse des Web Forms oder Windows Forms stellt die CrystalReportViewer-Klasse das einfachste Objektmodell des SDKs zur Verfügung. Dieses Objektmodell wird später in diesem Abschnitt erörtert.

Am einfachsten können Sie einen Bericht in ein Web Form oder Windows Form aufnehmen, indem Sie dem Formular das CrystalReportViewer-Steuerelement hinzufügen und anschließend der ReportSource-Eigenschaft der CrystalReportViewer-Klasse den Berichtpfad in der CodeBehind-Klasse als Zeichenfolge zuweisen.

Indem Sie dem Steuerelement den Berichtpfad direkt zuweisen (anstatt den Bericht in ein komplexeres Objektmodell wie ReportDocument oder ReportClientDocument aufzunehmen), können Sie die Schnittstelle auf das einfachste Objektmodell beschränken: CrystalRe

NoteAnmerkung

Weitere Informationen zur Auswahl eines Objektmodells finden Sie unter Welches Objektmodell sollte verwendet werden?.

Diagramm des CrystalReportViewer-Objektmodells

Diese Diagramme verdeutlichen die Beziehungen innerhalb des CrystalReportViewer-Objektmodells.

CrystalReportViewer verfügt über zwei Objektmodelldiagramme, da sowohl für Windows als auch für Webanwendungen derselbe Steuerelement- und Klassenname (und somit auch das zugrunde liegende Objektmodell) wiederverwendet wird. Folglich kommt das CrystalReportViewer-Objektmodell (mit geringen Abweichungen) in zwei verschiedenen Namespaces vor.

Die Windows-Version von CrystalReportViewer enthält die Hauptklassen und -ereignisse, die von der Windows- und Webversion des Objektmodells gemeinsam verwendet werden.

Abbildung 1: CrystalDecisions.Windows.Forms.CrystalReportViewer-Objektmodell

Die Webversion des CrystalReportViewer-Objektmodells enthält dieselben Klassen und Ereignisse wie die Windows-Version, verfügt zusätzlich aber über die folgenden Ereignisse, die mit dem Laden der ASPX-Seite zusammenhängen.

Abbildung 2: CrystalDecisions.Web.CrystalReportViewer-Objektmodell

Siehe auch