Binden des Berichts

Sofern Sie die Vorbereitungen für dieses Lernprogramm entsprechend den Anweisungen unter Projekt-Setup getroffen haben, befindet sich jetzt ein CrystalReportViewer-Steuerelement auf dem Web Form oder Windows Form. In den vorangehenden Schritten haben Sie dem Projekt einen Bericht mit dem Namen "CustomersByCity" hinzugefügt.

In diesem Abschnitt binden Sie den Dateiverzeichnispfad des Berichts CustomersByCity an das CrystalReportViewer-Steuerelement. Anschließend testen Sie, ob der Bericht ordnungsgemäß angezeigt wird, wenn für dessen Parameterfeld keine aktuellen Werte festgelegt wurden.

So binden Sie den Dateiverzeichnispfad des Berichts "CustomersByCity" an das CrystalReportViewer-Steuerelement

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

2. Klicken Sie im Menü Ansicht auf Code, um die CodeBehind-Klasse dieses Web Forms oder Windows Forms anzeigen zu lassen.

3. Suchen Sie die (unter Projekt-Setup erstellte) ConfigureCrystalReports()-Methode.

4. Deklarieren Sie eine Zeichenfolgenvariable, geben Sie ihr den Namen "reportPath", und weisen Sie ihr den Laufzeitpfad zum lokalen Bericht zu. Dieser Pfad wird für Website- und Windows-Projekte unterschiedlich definiert:

   • Bei einer Website übergeben Sie den Namen der lokalen Berichtsdatei als Zeichenfolgenparameter an die Server.MapPath()-Methode. Dadurch wird der lokale Bericht dem Dateiverzeichnispfad auf der Festplatte zur Laufzeit zugeordnet.

     Dim reportPath As String = Server.MapPath("CustomersByCity.rpt")
     

     string reportPath = Server.MapPath("CustomersByCity.rpt");
     

   • Bei einem Windows-Projekt verketten Sie die Application.StartupPath-Eigenschaft mit einem umgekehrten Schrägstrich und dem Namen der lokalen Berichtsdatei. In diesem Fall wird der Bericht demselben Verzeichnis zugeordnet, in dem sich auch die ausführbare Windows-Datei befindet.

     Anmerkung
     Zur Kompilierungszeit kopieren Sie den Bericht in das Verzeichnis, in dem sich die ausführbare Datei befindet.

     Dim reportPath As String = Application.StartupPath & "\" & "CustomersByCity.rpt"
     

     string reportPath = Application.StartupPath + "\\" + "CustomersByCity.rpt";
     

5. Weisen Sie der ReportSource-Eigenschaft des CrystalReportViewer-Steuerelements den Dateiverzeichnispfad des Berichts "CustomersByCity" zu.

   myCrystalReportViewer.ReportSource = reportPath
   

   crystalReportViewer.ReportSource = reportPath;
   

So überprüfen Sie das Laden des Berichts "CustomersByCity"

Sie können nun beginnen, Ihr Projekt zu erstellen und auszuführen. Es ist davon auszugehen, dass der Bericht nicht geladen wird, da noch kein Code zum Festlegen eines Werts für das Parameterfeld "Ort" geschrieben wurde.

1. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

2. Sollten Buildfehler vorhanden sein, beheben Sie diese jetzt bitte.

3. Bei einem nicht eingebetteten Bericht in einem Windows-Projekt suchen Sie die kompilierte ausführbare Windows-Datei im Unterverzeichnis \bin\ [Visual Basic] oder \bin\debug\ [C#], und kopieren Sie den Bericht in dieses Unterverzeichnis.

<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>Damit der nicht eingebettete Bericht von der ausführbaren Windows-Datei zur Laufzeit geladen wird, muss der Bericht im selben Verzeichnis wie die ausführbare Windows-Datei gespeichert werden.</p></td>
</tr>
</tbody>
</table>

4. Klicken Sie im Menü Debuggen auf Debuggen starten.

   Der Bericht "CustomersByCity" wird nicht angezeigt. Er ist erst sichtbar, nachdem Sie später in diesem Lernprogramm einen Wert für das Parameterfeld "Ort" hinzugefügt haben.

   Anmerkung

   Die Ergebnisse können je nach verwendeter Crystal Reports-Version variieren. In neueren Versionen wird ein Formular angezeigt, in dem Sie aufgefordert werden, Parameterwerte für diesen Bericht einzugeben. In früheren Versionen wird eine Ausnahme vom Typ "Aktueller Wert für Parameterfeld fehlt" ausgelöst. In beiden Fällen fügen Sie weiteren Code hinzu, um eine voll funktionsfähige Anwendung zu erhalten.

5. Kehren Sie zu Visual Studio zurück, und klicken Sie auf Debuggen beenden, um den Debugmodus zu verlassen.