Lernprogramm: Lesen und Einstellen diskreter Parameter

Einführung

Ein diskreter Parameter ist im Unterschied zu einem Bereichsparameter, der sich auf einen Wertebereich bezieht, ein einzelner Wert. Auf Textelemente (z. B. Orte) wird normalerweise über diskrete Parameter zugegriffen. Auf numerische Elemente (z. B. Mitarbeitergehälter) wird normalerweise über Bereichsparameter zugegriffen.

In diesem Lernprogramm legen Sie einen Wert für einen diskreten Parameter fest, um einen auf einem Feld basierenden Kundenbericht anzeigen zu lassen. Der Bericht zeigt nur diejenigen Kunden an, die in den aus einer Ortliste ausgewählten Orten ansässig sind. Die Ortsliste ist von den Standardwerten des Parameters "Ort" abgeleitet. Diese Standardwerte für den Parameter "Ort" sind innerhalb des Berichts eingekapselt.

Zunächst erstellen Sie einen Kundenbericht mit einem Parameter "Ort". Die Berichtdaten werden aus der mit Crystal Reports für Visual Studio bereitgestellten Musterdatenbank abgeleitet. Wenn Sie den Bericht im Code instantiieren, erstellen Sie eine ArrayList mit Ortsnamen ("Paris", "Tokyo") und übergeben diese ArrayList-Instanz an eine Hilfsmethode, durch die die Ortsnamen als aktuelle Werte für den Parameter "Ort" festgelegt werden. Anschließend binden Sie den Bericht an das CrystalReportViewer-Steuerelement und zeigen den Bericht nur unter Berücksichtigung derjenigen Kunden an, die in "Paris" und "Tokyo" ansässig sind.

Im nächsten Teil des Lernprogramms führen Sie folgende Schritte aus:

  • Erstellen einer Methode, durch die alle Standardwerte abgerufen und in einer ArrayList zurückgegeben werden.
  • Hinzufügen eines ListBox-Steuerelements zum Formular und Auffüllen des Steuerelements mit Werten aus der ArrayList.
  • Hinzufügen eines Button-Steuerelements zur erneuten Anzeige des Berichts auf der Grundlage der ListBox-Auswahlen.

Im letzten Teil des Lernprogramms codieren Sie das Click-Ereignis der Schaltfläche, um beliebige ausgewählte Elemente aus dem ListBox-Steuerelement abzurufen und sie als aktuelle Werte für den Parameter "Ort" festzulegen. Der Bericht wird erneut angezeigt und enthält jetzt nur Kunden in denjenigen Orten, die innerhalb des ListBox-Steuerelements ausgewählt wurden.

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_Parameters
  • C#-Windows-Projekt: CS_Win_CRVObjMod_Parameters
  • Visual Basic-Website: VB_Web_CRVObjMod_Parameters
  • Visual Basic-Windows-Projekt: VB_Win_CRVObjMod_Parameters

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

In diesem Abschnitt