Nachtrag: Verbesserter Code zum Einstellen diskreter Parameter

Sie haben erfolgreich einen Bericht mit einem diskreten Parameterwert und einer Hilfsmethode erstellt, die eine beliebige Wertegruppe in einem allgemeinen Format (einer ArrayList) aufnehmen kann, und diese Werte dann auf einen Bericht übertragen, der auf einem bestimmten Parameterfeldnamen (der PARAMETER_FIELD_NAME-Konstanten) basiert.

Wenn Sie Visual Studio 2005 oder höher installiert haben, können Sie auf die erweiterte API zugreifen, über die diskrete Parameter im Crystal Reports-Bericht festgelegt werden. Mithilfe der Crystal Reports Developer-API können Sie den Code verringern, der zur Einstellung diskreter Parameter erforderlich ist.

In den vorangehenden Prozeduren haben Sie gelernt, wie Sie die SetCurrentValuesForParameterField()-Hilfsmethode erstellen.

In diesem Lernprogramm können Sie die Hilfsmethode löschen und stattdessen die SetParameterValue()-Methode der ReportDocument-Klasse aufrufen.

Die SetParameterValue()-Methode wird in den folgenden überladenen Methoden bereitgestellt:

• SetParameterValue(int index, object value)
• SetParameterValue(string parameterFieldName, object value)
• SetParameterValue(string parameterFieldName, object value, string subreport)

Sie können einen beliebigen Objekttyp übergeben, dessen Wert den Anforderungen an Standardwerte für das Parameterfeld entspricht. Das Objekt kann eine Array-Instanz sein, in der eine Liste von Parameterwerten gespeichert ist.

Voraussetzungen:

• Es muss ein Projekt erstellt werden, das auf den Anweisungen unter Lernprogramm: Lesen und Einstellen diskreter Parameter basiert.

  Unter Manuelles Festlegen von Parametern im Code muss jedoch nur die PARAMETER_FIELD_NAME-Konstante erstellt werden. Es ist nicht erforderlich, die SetCurrentValuesForParameterField()-Hilfsmethode zu erstellen.

• Falls Sie bereits über ein Projekt verfügen, das auf den Anweisungen unter Lernprogramm: Lesen und Einstellen diskreter Parameter basiert, löschen Sie die SetCurrentValuesForParameterField()-Hilfsmethode sowie den Aufruf innerhalb der ConfigureCrystalReports()-Methode.

So verwenden Sie die SetParameterValue()-Methode für diskrete Parameter

1. Öffnen Sie das abgeschlossene Projekt für dieses Lernprogramm.

2. Öffnen Sie das Web Form oder Windows Form.

3. Klicken Sie im Menü Ansicht auf Code.

4. Rufen Sie innerhalb der ConfigureCrystalReports()-Methode und oberhalb der Zeile, durch die der Bericht an die ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements gebunden wird, die SetParameterValue()-Methode aus der CustomerByCity-Klasse auf. Übergeben Sie den Parameterfeldnamen und die Parameterwerte einer Array-Instanz an die Methode.

   customersByCityReport.SetParameterValue(PARAMETER_FIELD_NAME, arrayList.ToArray())
   

   customersByCityReport.SetParameterValue(PARAMETER_FIELD_NAME, arrayList.ToArray());
   

Sie können das Projekt jetzt erstellen und ausführen, um diskrete Parameter zu lesen und einzustellen.