Hinzufügen von Code zur Auswahl einer Berichtseite

In diesem Abschnitt erfahren Sie, wie Sie die Option "Gehe zu Seite" der CrystalReportViewer-Symbolleiste codieren.

Die CrystalReportViewer-Symbolleiste verfügt über Schaltflächen zur Seitennavigation sowie über ein Textfeld zur Auswahl von Berichtseiten. Anhand der folgenden Methoden aus der CrystalReportViewer-Klasse können Sie Code für Seitenauswahlen manuell schreiben:

• ShowFirstPage()
• ShowLastPage()
• ShowNextPage()
• ShowNthPage(int PageNumber)
• ShowPreviousPage()

Sobald eine dieser Methoden aufgerufen wird, wird die ausgewählte Seite für den aktuellen Bericht angezeigt.

So fügen Sie die Steuerelemente TextBox und Button für die Option "Gehe zu Seite" hinzu

1. Öffnen Sie das Web Form oder Windows Form in der Entwurfsansicht.
2. Ziehen Sie ein TextBox-Steuerelement aus der Toolbox in die vierte Zeile und erste Spalte der Tabelle.
3. Wählen Sie das TextBox-Steuerelement aus, und verfahren Sie dann im Fenster Eigenschaften wie folgt:
4. Setzen Sie ID (oder Name) auf "pageNumber".
5. Lassen Sie die Text-Eigenschaft leer.
6. Ziehen Sie ein Button-Steuerelement aus der Toolbox in die vierte Zeile und zweite Spalte der Tabelle.
7. Wählen Sie das Button-Steuerelement aus, und verfahren Sie dann im Fenster Eigenschaften wie folgt:
   1. Setzen Sie ID (oder Name) auf "goToPage".
   2. Setzen Sie Text auf "Gehe zu Seite".

So codieren Sie den Click()-Ereignishandler für das Button-Steuerelement

1. Doppelklicken Sie auf das Button-Steuerelement Gehe zu Seite.

Die CodeBehind-Klasse des Berichts wird angezeigt. Ein goToPage\_Click()-Ereignishandler wurde automatisch generiert.

2. Konvertieren Sie den in das TextBox-Steuerelement eingegebenen Text in eine Ganzzahl, und übergeben Sie dann den Wert an die ShowNthPage()-Methode des CrystalReportViewer-Steuerelements.

   Anmerkung
   Es wurde nicht überprüft, ob eine Ganzzahl in das TextBox-Steuerelement eingegeben wurde. Bei einer Produktionsanwendung würden Sie ein Validierungssteuerelement hinzufügen, das für die Überprüfung des TextBox-Steuerelements konfiguriert ist.

   myCrystalReportViewer.ShowNthPage(Convert.ToInt32(pageNumber.Text))
   

   crystalReportViewer.ShowNthPage(Convert.ToInt32(pageNumber.Text));
   

So testen Sie das Button-Steuerelement goToPage

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

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

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

Der Bericht "Chart" wird mit allen hinzugefügten Steuerelementen angezeigt.

4. Geben Sie in das TextBox-Steuerelement pageNumber den Wert 3 ein, und klicken Sie dann auf Gehe zu Seite.

   Die Seite wird neu geladen, wobei Seite 3 des Berichts angezeigt wird.

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