CrystalReportViewer.OnDrill Methode

Diese Methode synchronisiert das Drill-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 OnDrill ( _
    ByVal source As Object, _   
    ByVal e As CrystalDecisions.Web.DrillEventArgs _    
)

public virtual void OnDrill (
    object source,
    CrystalDecisions.Web.DrillEventArgs e
)

Parameter

source
Das CrystalReportViewer-Steuerelement.

e
Die auf das Drill-Ereignis bezogenen Daten.

Anmerkungen

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

Mit dieser Methode können Daten zwischen zwei Berichten verglichen werden. Eine Webanwendung zeigt beispielsweise zwei monatliche Umsatzberichte an, einen für Dezember und einen für Januar. Wenn ein Drilldown auf den Umsatzbericht von Dezember ausgeführt wird, werden die Aktionen des Dezemberberichts im Januarbericht 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 DrillEventHandler für CrystalReportViewer1 erstellt wird, durch den das Ereignis mithilfe der OnDrill-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("DecemberSales.rpt")
         Me.CrystalReportViewer2.ReportSource =  _
            Me.MapPath("JanuarySales.rpt")
         AddHandler CrystalReportViewer1.Drill, _
            AddressOf(CrystalReportViewer2.OnDrill)
      
      End Sub

      private void Page_Load(object sender, System.EventArgs e)
      {
         CrystalReportViewer1.ReportSource = 
            this.MapPath("DecemberSales.rpt");
         CrystalReportViewer2.ReportSource = 
            this.MapPath("JanuarySales.rpt");
         this.CrystalReportViewer1.Drill += new 
            CrystalDecisions.Web.DrillEventHandler
            (CrystalReportViewer2.OnDrill);
      }

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