Festlegen von Parametern

Wenn Sie einen Crystal Reports-Bericht erstellen, wird die Datenauswahl für den Bericht durch das "where"-Kriterium gesteuert. Dabei kann der Wert für das "where"-Kriterium hartcodiert sein. Falls jedoch ein dynamischer Wert erforderlich ist, wird ein Parameter erstellt und die "where"-Klausel dem Parameter zugewiesen. Parameter werden, je nachdem, ob Sie ein Codierungsmodell oder ein codereduzierten Modell zur Entwicklung verwenden, unterschiedlich behandelt.

Bei der Entwicklung mit einem Codierungsmodell erfolgen Parameterzugriff und -interaktion in Crystal Reports für Visual Studio über eine Gruppe parameterbezogener Klassen im Crystal Reports SDK.

Bei der Entwicklung mit einem codereduzierten Modell (dem tagbasierten Anwendungsmodell) erfolgen Parameterzugriff und -interaktion unter Verwendung des Parameters-Frameworks über das CrystalReportSource-Steuerelement. Das Parameters-Framework ist ein neues Feature in ASP.NET, Version 2.0. Über dieses Framework können Parameter einem beliebigen DataSource-Steuerelement (in diesem Fall einem CrystalReportSource-Steuerelement) zugewiesen werden. Diese Parameter können sowohl dem Hauptbericht als auch einem beliebigen Unterbericht zugewiesen werden, falls diese Parameter erfordern.

Ein Parameter wird von einem der folgenden Parametertypen zugewiesen:

• ControlParameter
• QueryStringParameter
• SessionParameter
• FormParameter
• CookieParameter

Durch diese Parameterzuweisung können Sie eine codereduzierte Lösung entwickeln, in der die Berichtparameter über Auswahlen aus folgenden Objekten festgelegt werden können: DropDownList-Steuerelemente (bzw. andere Steuerelementtypen), Werte in der URL-Abfragezeichenfolge, aus Session abgerufene Werte, von Formularfeldern übermittelte Werte oder Werte aus einem Cookie.

Direktes Einrichten von "Parameters" in XML

In XML wird das <Parameters>-Tag im <CrystalReportSource>-Tag geschachtelt. Innerhalb des geschachtelten <Parameters>-Tags können Verknüpfungen zu einem Standardparameter oder einem Parameter aus einem Steuerelement konfiguriert werden.

Programmgesteuertes Festlegen von Parametern

Im Codierungsmodell des Crystal Reports-SDKs bestand schon immer die Möglichkeit, Parameter festzulegen. Weitere Informationen finden Sie unter Lernprogramm: Lesen und Einstellen diskreter Parameter und Lernprogramm: Lesen und Einstellen diskreter Parameter.

So greifen Sie auf den Parameterauflistungs-Editor zu

Parameter werden im Dialogfeld Parameterauflistungs-Editor konfiguriert.

1. Wählen Sie das CrystalReportSource-Steuerelement aus.

2. Erweitern Sie unter Eigenschaften die Option Report.

3. Klicken Sie innerhalb der Report-Eigenschaft auf die Auslassungspunkte (...), die sich rechts neben Parameters (Collection) befinden.

4. Geben Sie im Dialogfeld Auflistungs-Editor für Parameter einen oder mehrere Parameter für den Hauptbericht sowie für eventuelle Unterberichte ein.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\xkh1wxd8.alert_note(de-de,VS.90).gif" alt="Note" class="note" />Anmerkung</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Ausführliche Hinweise zur Konfiguration dieses Dialogfeldes finden Sie im Lernprogramm <a href="ms227796(v=vs.90).md">Anmelden bei einer sicheren Datenbank unter Verwendung von reduziertem Code in einer Website</a>.</p></td>
</tr>
</tbody>
</table>