Lernprogramm: Lesen und Einstellen von Parametern für einen Unterbericht

NoteAnmerkung

Zum Ausführen dieses Lernprogramms müssen Sie das vorherige Lernprogramm Lernprogramm: Lesen und Einstellen diskreter Parameter bearbeitet haben.

Einführung

Im vorangehenden Lernprogramm Lernprogramm: Lesen und Einstellen diskreter Parameter haben Sie gelernt, wie Sie einen Bericht mit einem Parameter erstellen und wie Sie Code zum Festlegen dieses Parameters zur Laufzeit schreiben. Dabei wurden die Verfahrensweisen für hartcodierte Parameterwerte sowie für Parameterwerte beschrieben, die von einem ListBox-Steuerelement übergeben werden.

In diesem Lernprogramm erfahren Sie, wie Sie einem Unterbericht Parameter hinzufügen.

Dazu sind vier Änderungen an dem unter Lernprogramm: Lesen und Einstellen diskreter Parameter erstellten Projekt erforderlich:

  • Hinzufügen eines Unterberichts zum Originalbericht.

    Dieser Unterbericht bezieht sich auf die Tabelle "Aufträge" der Xtreme-Datenbank. Die Tabelle "Aufträge" bezieht sich auf die Tabelle "Kunden", die im vorangehenden Lernprogramm vom Fremdschlüssel "CustomerID" verwendet wird.

  • Hinzufügen eines Bereichsparameters zum Unterbericht, der eine Filterung auf der Grundlage eines Auftragsdatumsbereichs durchführt.

  • Sie fügen dem Formular die beiden Text-Steuerelemente orderStartDate und orderEndDate hinzu, um den Auftragsdatumsbereich zur Laufzeit festzulegen.

  • Hinzufügen einer neuen Methode.

    Durch diese Methode wird eine ParameterRangeValue-Instanz erstellt, die die startDate- und endDate-Werte enthält. Anschließend übergibt die Methode diese ParameterRangeValue-Instanz an den Bereichsparameter innerhalb des Unterberichts.

Nach Beendigung dieses Lernprogramms können Sie die Werte filtern, die zur Laufzeit im Bericht angezeigt werden. Durch den hinzugefügten Code werden die Anzahl der im Hauptbericht angezeigten Orte sowie der im Unterbericht anzuzeigende Auftragsdatumsbereich beschränkt.

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 von Objektmodellen finden Sie unter Welches Objektmodell sollte verwendet werden?

Um dieses Lernprogramm mit dem CrystalReportViewer-Objektmodell zu erstellen, informieren Sie sich unter Lernprogramm: Lesen und Einstellen von Bereichsparametern für einen Unterbericht.

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_ParametersSubrpt
  • C#-Windows-Projekt: CS_Win_RDObjMod_ParametersSubrpt
  • Visual Basic-Website: VB_Web_RDObjMod_ParametersSubrpt
  • Visual Basic-Windows-Projekt: VB_Win_RDObjMod_ParametersSubrpt

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

In diesem Abschnitt

Siehe auch

  • Last updated on