基本介紹
- 中文名：報表查看器
- 外文名：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);
}
}
}
}
也就是說，對於報表中的一些業務邏輯設定，是不應該放到這個顯示類中的，而是應該由調用方負責進行設定與刷新。
評價
- 免費-微軟自帶的免費報表控制項，不存在任何著作權或者限制
- 簡單-CrystalReportViewer適合輕量的報表，開發相對簡單
- 所見即所得-你只要在報表中設定好格式，列印出來是跟你看到的報表一樣的
- 查看/列印-CrystalReportViewer報表瀏覽器集成了報表查看及列印預覽功能，可直接輸出到印表機，也可直接
- 出為Excel檔案或PDF檔案，對於習慣Excel表格的人來說，CrystalReportViewer報表控制項非常適合
- 雙平台-既可以在Web程式中使用，也可以在Windows程式中使用
