CrystalReportViewer.OnDrill Méthode

Article
04/22/2008

Synchronise l'événement Drill entre deux contrôles CrystalReportViewer en agissant comme gestionnaire d'événements par défaut pour le second contrôle.

Espace de noms CrystalDecisions.Web Assembly CrystalDecisions.Web (CrystalDecisions.Web.dll)

Syntaxe

Public Overrideable Sub OnDrill ( _
    ByVal source As Object, _   
    ByVal e As CrystalDecisions.Web.DrillEventArgs _    
)

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

Paramètres

source
Contrôle CrystalReportViewer.

e
Données liées à l'événement Drill.

Remarques

Lorsque l'événement Drill se déclenche dans un CrystalReportViewer (CrystalReportViewer1), la méthode OnDrill agit comme gestionnaire d'événements par défaut pour un autre CrystalReportViewer (CrystalReportViewer2). Ce scénario se produit lorsqu'un nouveau DrillEventHandler créé pour CrystalReportViewer1 utilise l'adresse de la méthode OnDrill de CrystalReportViewer2 comme argument. Lorsque l'utilisateur explore le sous-rapport dans CrystalReportViewer1, le sous-rapport de CrystalReportViewer2 reflète l'activité du rapport dans CrystalReportViewer1. Tout code d'événement Drill dans CrystalReportViewer2 est ignoré, car l'événement qui figure dans CrystalReportViewer2 n'est pas déclenché. Le fait d'explorer le sous-rapport dans CrystalReportViewer2 permet l'exécution de l'événement Drill pour CrystalReportViewer2, ainsi que de tout autre code.

Cette méthode permet de comparer les données de deux rapports. Prenons l'exemple d'une application Web qui affiche deux rapports mensuels de ventes, pour les mois de décembre et de janvier, respectivement. Lorsque l'utilisateur explore le rapport détaillant les ventes de décembre, le rapport de janvier reflète les actions du rapport de décembre. L'utilisateur peut ainsi comparer les chiffres des ventes des deux rapports sans devoir répéter les mêmes actions dans chaque rapport.

Exemple

Cet exemple montre comment créer le DrillEventHandler pour CrystalReportViewer1 qui va déléguer l'événement à CrystalReportViewer2 via la méthode OnDrill. L'exemple définit la source du rapport pour le contrôle CrystalReportViewer, puis crée le gestionnaire d'événements.

      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);
      }

Informations de version

Crystal Reports Basic for Visual Studio 2008

Pris en charge depuis : Crystal Reports for Visual Studio .NET 2002

Voir aussi

Référence

CrystalReportViewer Classe
CrystalReportViewer Membres
CrystalDecisions.Web Espace de noms

Partager via