Binden des Berichts

Sofern Sie die Vorbereitungen für dieses Lernprogramm entsprechend den Anweisungen im Abschnitt 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 den Bericht "CustomersBySalesName" und eine Auswahlformel hinzugefügt.

In diesem Abschnitt binden Sie den Dateiverzeichnispfad des Berichts CustomersBySalesName an das CrystalReportViewer-Steuerelement. Anschließend überprüfen Sie, ob der Bericht ordnungsgemäß angezeigt wird, d. h., ob mithilfe der Auswahlformel die richtigen Datensätze herausgefiltert wurden.

So binden Sie den Dateiverzeichnispfad des Berichts "CustomersBySalesName" 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("CustomersBySalesName.rpt")
     

     string reportPath = Server.MapPath("CustomersBySalesName.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 & "\" &
     "CustomersBySalesName.rpt"
     

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

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

   myCrystalReportViewer.ReportSource = reportPath
   

   crystalReportViewer.ReportSource = reportPath;
   

So testen Sie die Auswahlformel für den Bericht "CustomersBySalesName"

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 angezeigte Crystal Reports-Bericht enthält vier Kundendatensätze: Alley Cat Cycles, Ankara Bicycle Company, Arsenault et Maurier und Athens Bicycle Co.

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