CrystalReportViewer.OnRefresh メソッド

2 つの CrystalReportViewer コントロールの間で ReportRefresh イベントを同期させるために、2 番目のコントロールのデフォルトのイベント ハンドラとして機能します。

名前空間 CrystalDecisions.Web アセンブリ CrystalDecisions.Web (CrystalDecisions.Web.dll)

構文

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

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

パラメータ

• source
  CrystalReportViewer コントロール

• e
  ReportRefresh イベントに関連するデータです。

解説

ReportRefresh イベントが 1 つ目の CrystalReportViewer（CrystalReportViewer1）で発生すると、OnRefresh メソッドは、もう 1 つの CrystalReportViewer（CrystalReportViewer2）のデフォルトのイベント ハンドラとして機能します。この動作は、CrystalReportViewer1 で新規に作成する RefreshEventHandler で、CrystalReportViewer2 の OnRefresh メソッドのアドレスを引数として使用することによって実現されます。ユーザーが CrystalReportViewer1 内のレポートを最新表示すると、CrystalReportViewer2 内のレポートには、CrystalReportViewer1 内のレポートのアクティビティが反映されます。CrystalReportViewer2 ではイベントが発生しないので、CrystalReportViewer2 内の ReportRefresh イベント コードは無視されます。ユーザーが CrystalReportViewer2 内のレポートを最新表示すると、CrystalReportViewer2 の ReportRefresh イベントと後続のコードが実行されます。

この方法は、2 つのレポート間のデータを比較するときに利用できます。たとえば、Web アプリケーションで 2 つの売上レポート（西日本のレポートと東日本のレポート）を表示するとします。西日本の売上レポートが最新表示されると、東日本の売上レポートに西日本の売上レポートに対する操作が反映されます。ユーザーは、レポートごとに操作を繰り返さなくても、2 つのレポート間で売上高を比較できます。

例

次の例は、OnRefresh メソッドを介して CrystalReportViewer2 にイベントを依頼する RefreshEventHandler を、CrystalReportViewer1 で新規に作成する方法を示します。この例では CrystalReportViewer コントロールのレポート ソースを設定し、イベント ハンドラを作成します。

'宣言

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

バージョン情報

Crystal Reports Basic for Visual Studio 2008

サポートの開始： Crystal Reports for Visual Studio .NET 2002

参照

リファレンス

CrystalReportViewer クラス
CrystalReportViewer メンバ
CrystalDecisions.Web 名前空間