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.
Einführung
Im vorangehenden Lernprogramm Lernprogramm: Lesen und Einstellen diskreter Parameter haben Sie gelernt, wie Sie einen Bericht mit einem diskreten Parameter erstellen und wie Sie Code zum Festlegen des Parameters zur Laufzeit schreiben. Dabei wurden die Verfahrensweisen für hartcodierte Parameterwerte sowie für Parameterwerte beschrieben, die von einem ListBox- bzw. TextBox-Steuerelement übergeben werden.
In diesem Lernprogramm erfahren Sie, wie Sie einem Unterbericht Bereichsparameter hinzufügen.
Dazu sind vier Änderungen an dem zuvor 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.
Ändern der im vorherigen Lernprogramm erstellten SetCurrentValuesForParameter()-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.
Für dieses Lernprogramm können auch Klassen des ReportDocument-Objektmodells verwendet werden. Siehe Lernprogramm: Lesen und Einstellen von Parametern für einen Unterbericht. Weitere Informationen zur Verwendung von Objektmodellen finden Sie unter Welches Objektmodell sollte verwendet werden?
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_CRVObjMod_ParametersSubrpt
- C#-Windows-Projekt: CS_Win_CRVObjMod_ParametersSubrpt
- Visual Basic-Website: VB_Web_CRVObjMod_ParametersSubrpt
- Visual Basic-Windows-Projekt: VB_Win_CRVObjMod_ParametersSubrpt
Nähere Angaben zum Speicherort der Ordner mit diesen Beispielen finden Sie unter Verzeichnis mit Beispielcode für Lernprogramme.