CrystalReportViewer.OnRefresh Methode

Diese Methode synchronisiert das ReportRefresh-Ereignis zwischen zwei CrystalReportViewer-Steuerelementen, indem sie als Standardereignishandler für das zweite Steuerelement fungiert.

Namespace CrystalDecisions.Web Assembly CrystalDecisions.Web (CrystalDecisions.Web.dll)

Syntax

Public Overrideable Sub OnRefresh ( _
    ByVal source As Object, _   
    ByVal e As CrystalDecisions.Web.ViewerEventArgs _   
)

public virtual void OnRefresh (
    object source,
    CrystalDecisions.Web.ViewerEventArgs e
)

Parameter

source
Das CrystalReportViewer-Steuerelement

e
Die auf das ReportRefresh-Ereignis bezogenen Daten.

Anmerkungen

Wenn das ReportRefresh-Ereignis in einem CrystalReportViewer (z.B. CrystalReportViewer1) ausgelöst wird, agiert die OnRefresh-Methode als Standardereignishandler für einen anderen CrystalReportViewer (z.B. CrystalReportViewer2). Dieses Szenario ist gegeben, wenn ein neuer RefreshEventHandler für CrystalReportViewer1 erstellt wurde, der die Adresse der OnRefresh-Methode von CrystalReportViewer2 als Argument verwendet. Wenn der Anwender den Bericht in CrystalReportViewer1 aktualisiert, spiegelt der Bericht in CrystalReportViewer2 die Berichtsaktivität in CrystalReportViewer1. Sämtlicher ReportRefresh-Ereigniscode in CrystalReportViewer2 wird ignoriert, da das Ereignis in CrystalReportViewer2 nicht ausgelöst wird. Wenn der Anwender den Bericht in CrystalReportViewer2 aktualisiert, wird das ReportRefresh-Ereignis für CrystalReportViewer2 und den gesamten nachfolgenden Code ausgeführt.

Mit dieser Methode können Daten zwischen zwei Berichten verglichen werden. In einer Webanwendung werden z. B. zwei Umsatzberichte angezeigt, einer für die Westregion und einer für die Ostregion. Sobald der Umsatzbericht der Westregion aktualisiert wird, werden die Aktionen des Umsatzberichts "Westregion" im Umsatzbericht "Ostregion" widergespiegelt. Der Anwender kann daraufhin die Umsatzzahlen zwischen den beiden Berichten vergleichen, ohne die Aktionen für den jeweiligen Bericht zu duplizieren.

Beispiel

In diesem Beispiel wird veranschaulicht, wie der neue RefreshEventHandler für CrystalReportViewer1 erstellt wird, durch den das Ereignis mithilfe der OnRefresh-Methode an CrystalReportViewer2 delegiert wird. Im Beispiel wird die Berichtquelle für das CrystalReportViewer-Steuerelement festgelegt und der Ereignishandler erstellt.

      Private Sub Page_Load _
         (ByVal sender As System.Object, ByVal e As System.EventArgs) _
         Handles MyBase.Load
      
         Me.CrystalReportViewer1.ReportSource = _ 
            Me.MapPath("WesternSales.rpt")
         Me.CrystalReportViewer2.ReportSource =  _
            Me.MapPath("EasternSales.rpt")
         AddHandler CrystalReportViewer1.ReportRefresh, _
            AddressOf(CrystalReportViewer2.OnRefresh)
      
      End Sub

      private void Page_Load(object sender, System.EventArgs e)
      {
         CrystalReportViewer1.ReportSource = 
            this.MapPath("WesternSales.rpt");
         CrystalReportViewer2.ReportSource = 
            this.MapPath("EasternSales.rpt");
         this.CrystalReportViewer1.ReportRefresh += new 
            CrystalDecisions.Web.RefreshEventHandler
            (CrystalReportViewer2.OnRefresh);
      }

Versionsinformationen

Crystal Reports Basic for Visual Studio 2008

Unterstützt ab: Crystal Reports for Visual Studio .NET 2002

Siehe auch

Referenz

CrystalReportViewer Klasse
CrystalReportViewer Elemente
CrystalDecisions.Web Namespace

Last updated on 2008-04-22