显示水晶报表的公用类

在应用程序中,通常我们都需要显示报表。在.net中,我们大多数情况使用了水晶报表,如果我们不是直接将报表发送到打印机打印,那么就需要将报表显示出来,这种情况下需要使用报表查看器(CrystalReportViewer)。
    CrystalReportViewer作为一个控件,它需要一个承载它的窗体或页面,我们这里只讨论窗体(WinForm)的情况。大多数情况下,我们 显示报表的界面都是相同的,因此,我们一般会做一个窗体类,来显示我们不同的报表。在有的实现中,我们是在这个窗体类中实例化我们所需要的报表对象的,当 我们每次要显示不同的报表时,都需要去维护这个报表显示窗体类,这样会给我们带来许多不便。更有甚者,把一些报表的逻辑也写到了这个窗体类中,这样严重违 反了类的单一职责原则,并且使我们的报表与报表显示之前有很强的依赖性。
    为了遵循类的单一职责原则,破除它们之前的相互依赖性,在下面我将提供一个实现水晶报表显示的范例,这个范例的灵感来源于 MessageBox类,只提供了几个静态公共方法用于显示报表:

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using CrystalDecisions.CrystalReports.Engine;
using ChiefValueAccounting.Util;
namespace ChiefValueAccounting.Win.Print
{
 /// <summary>
 /// 显示与打印水晶报表。
 /// </summary>
 public class CrystalReportBox
 {
  private static CrystalDecisions.Windows.Forms.CrystalReportViewer crystalReportViewer;
  private static System.Windows.Forms.Form frmReport;
  static CrystalReportBox()
  {
   InitializeComponent();
  }

  private static void InitializeComponent()
  {
   frmReport = new Form();
   crystalReportViewer = new CrystalDecisions.Windows.Forms.CrystalReportViewer();
   frmReport.SuspendLayout();
   //
   // crystalReportViewer
   //
   crystalReportViewer.ActiveViewIndex = -1;
   crystalReportViewer.DisplayGroupTree = false;
   crystalReportViewer.Dock = System.Windows.Forms.DockStyle.Fill;
   crystalReportViewer.Location = new System.Drawing.Point(0, 0);
   crystalReportViewer.Name = "crystalReportViewer";
   crystalReportViewer.ReportSource = null;
   crystalReportViewer.Size = new System.Drawing.Size(708, 482);
   crystalReportViewer.TabIndex = 0;
   //
   // frmReport
   //
   frmReport.AutoScaleBaseSize = new System.Drawing.Size(5, 13);
   frmReport.ClientSize = new System.Drawing.Size(708, 482);
   frmReport.Controls.Add(crystalReportViewer);
   frmReport.Name = "FormPrintReportEx";
   frmReport.StartPosition = System.Windows.Forms.FormStartPosition.CenterParent;
   frmReport.Text = "Report Viewer";
   frmReport.WindowState = System.Windows.Forms.FormWindowState.Maximized;
   frmReport.MaximizeBox = false;
   frmReport.MinimizeBox = false;
   frmReport.ShowInTaskbar = false;
   frmReport.FormBorderStyle = FormBorderStyle.FixedDialog;
   frmReport.ResumeLayout(false);
  }
  /// <summary>
  /// 显示水晶报表,要求调用方设置好报表对象的所有属性。
  /// </summary>
  /// <param name="reportClass">强类型的报表对象</param>
  public static void ShowReport(CrystalDecisions.CrystalReports.Engine.ReportClass reportClass, System.Windows.Forms.IWin32Window owner)
  {
   try
   {
    crystalReportViewer.ReportSource = reportClass;
    frmReport.ShowDialog(owner);
   }
   catch(Exception ex)
   {
    SimpleLogger.Log(ex);
    Global.ShowError(ex);
   }
  }
  /// <summary>
  /// 显示水晶报表,要求调用方设置好报表对象的所有属性。
  /// </summary>
  /// <param name="reportDocument">水晶报表文档对象</param>
  public static void ShowReport(CrystalDecisions.CrystalReports.Engine.ReportDocument reportDocument, System.Windows.Forms.IWin32Window owner)
  {
   try
   {
    crystalReportViewer.ReportSource = reportDocument;
    frmReport.ShowDialog(owner);
   }
   catch(Exception ex)
   {
    SimpleLogger.Log(ex);
    Global.ShowError(ex);
   }
  }
  /// <summary>
  /// 显示水晶报表。
  /// </summary>
  /// <param name="reportName">报表名称</param>
  /// <param name="dataSource">报表数据源</param>
  public static void ShowReport(string reportName, object dataSource, System.Windows.Forms.IWin32Window owner)
  {
   try
   {
    ReportDocument rd = new ReportDocument();
    rd.Load(reportName);
    rd.SetDataSource(dataSource);
    frmReport.ShowDialog(owner);
   }
   catch(Exception ex)
   {
    SimpleLogger.Log(ex);
    Global.ShowError(ex);
   }
  }
 }
}
也就是说,对于报表中的一些业务逻辑设置,是不应该放到这个显示类中的,而是应该由调用方负责进行设置与刷新。
 欢迎大家提出宝贵的反馈信息!

原文连接 http://www.cnblogs.com/jigee/archive/2006/04/30/389507.html