水晶報表是一個功能強大的報表工具,現在已經被Microsoft Visual Studio 2008與Microsoft Visual Studio 2005(下文以VS2005簡稱)集成在一起。
首先介紹一下我用的軟件環境:Microsoft Visual Studio 2005;Microsoft SQL Server 2005 【數據用例】
服務器:SQLEXPRESS 數據庫名:Test 數據庫表:T
【說明】 水晶報表在應用時分兩種方法,分別是拉模式(PULL)、推模式(PUSH)。
拉模式:在水晶報表生成時的數據源是從水晶報表文件中的SQL語句從數據庫中提取的,在編程時不用重寫SQL語句,但要加上登錄信息(具體方法,后面介紹)。
推模式:在水晶報表生成時的數據源,是用編程時重寫水晶報表中SQL語句而生成的dataset對像。也就是說,推模式是用dataset組裝水晶報表。
水晶報表組件介紹。水晶報表在VS2005中有兩種組件,在WEB項目是分別是CrystalReportSource,CrystalReportViewer。在FORM項目里是分別是crystalReport,CrystalReportViewer。 CrystalReportSource,crystalReport是水晶報表的數據提供者;CrystalReportViewer是水晶報表的瀏覽器。另外還要介紹一下水的報表的文件是以rpt為擴展名的文件,該文件可以用VS2005生成。
下面分別介紹具體操作方法:
拉模式(PULL): 在拉模式中如要在水晶報表中的SQL語句加上條件參數時要用{?參數名}方式給出。例:“_selectT1, T2, T3 FROM T Where T1=''{?parm}''” parm就是參數名 以下例子中所用到的水晶報表文件中使用的SQL語句是“_selectT1, T2, T3 FROM T Where T1=''{?parm}''” parm就是參數名。
【WEB方式下】
using CrystalDecisions.Shared;
using CrystalDecisions.CrystalReports.Engine;
///<summary> ///功能:拉模式提取水晶報表
///</summary> ///<param name="sender"></param>
///<param name="e"></param>
protectedvoid Button_pull_Click(object sender, EventArgs e)
{
// CrystalReport.rpt是水晶報表文件的名稱;
CrystalReportSource1是從工具箱加到頁面上的水晶報表數據源對像。
CrystalReportSource1.ReportDocument.Load(Server.MapPath("CrystalReport.rpt"));
// SetDatabaseLogon 拉模式中必須用這個方法來設置登錄信息,參數一:用戶名;參數二:密碼;參數三:服務器;參數四:數據庫名
CrystalReportSource1.ReportDocument.SetDatabaseLogon("sa", "123456", @"SYWZSWL\SQLEXPRESS", "Test"); //給水晶報表傳參數,參數一:是參數名,參數二:參數值; CrystalReportSource1.ReportDocument.SetParameterValue("Title", "這是一個測試報表");
CrystalReportSource1.ReportDocument.SetParameterValue("Parm", "1"); //綁定水晶報表數據源。
CrystalReportSource1.DataBind(); // CrystalReportViewer1是水晶報表瀏覽器,下面是給該瀏覽器賦上對像
CrystalReportViewer1.ReportSource = CrystalReportSource1;
CrystalReportViewer1.DataBind();
}
【FORM方式下】
//在FORM方式下代碼同WEB方式,用crystalReport控件換掉了CrystalReportSource;用crystalReportViewer換掉了CrystalReportViewer;這兩個控件都可以在工具箱里找到。同時在編程時去掉DataBind()方法。
privatevoid Form1_Load(object sender, EventArgs e)
{
crystalReport1.Load(Application.StartupPath + "CrystalReport.rpt");
crystalReport1.SetDatabaseLogon("sa", "123456", @"SYWZSWL\SQLEXPRESS", "Test");
crystalReport1.SetParameterValue("Title", "這是一個測試報表");
crystalReport1.SetParameterValue("Parm", "1");
crystalReportViewer1.ReportSource = crystalReport1;
}
推模式(PUSH):
在推模式中編程組裝的Dataset里的SQL語句中的字段要與水晶報表里的SQL語句字段一致。簡單的說,推模式中的水晶報表是個模板,把在設計器里報表的格式設好后,再組裝DataSet就可以生成報表了。
【WEB方式下】
using CrystalDecisions.Shared;
using CrystalDecisions.CrystalReports.Engine;
using System.Data.SqlClient;
protectedvoid Button_push_Click(object sender, EventArgs e)
{
string sql = "_selectT1, T2, T3 FROM T where T1=''a''";
string DBConfig_sql = @"Data Source=SYWZSWL\SQLEXPRESS;Initial Catalog=Test;User ID=sa;Password=123456";
DataSet ds = newDataSet();
SqlConnection sqlCon = newSqlConnection(DBConfig_sql);
SqlCommand sqlCmd = newSqlCommand(sql, sqlCon);
SqlDataAdapter sqlAd = newSqlDataAdapter();
sqlAd.SelectCommand = sqlCmd;
sqlAd.Fill(ds, "sql");
CrystalReportSource1.ReportDocument.Load(Server.MapPath("CrystalReport.rpt")); //注意此處必需指明Dataset中的表的名稱,否則會提示“您請求的報表需要更多信息.”
CrystalReportSource1.ReportDocument.SetDataSource(ds.Tables["sql"]);
//{?}中的參數可以不用賦值,即使賦了值也不起作用。
// CrystalReportSource1.ReportDocument.ParameterFields["Parm"].CurrentValues.AddValue("1234567");
CrystalReportSource1.ReportDocument.ParameterFields["Title"].CurrentValues.AddValue("這時推模式的報表樣例!");
CrystalReportSource1.DataBind();
CrystalReportViewer1.ReportSource = CrystalReportSource1;
CrystalReportViewer1.DataBind();
}
【FORM方式下】 privatevoid Form1_Load(object sender, EventArgs e)
{
//推模式
string sql = "_selectT1, T2, T3 FROM T where T1=''a''";
string DBConfig_sql = @"Data Source=SYWZSWL\SQLEXPRESS;Initial Catalog=Test;User ID=sa;Password=123456";
DataSet ds = newDataSet();
SqlConnection sqlCon = newSqlConnection(DBConfig_sql);
SqlCommand sqlCmd = newSqlCommand(sql, sqlCon);
SqlDataAdapter sqlAd = newSqlDataAdapter();
sqlAd.SelectCommand = sqlCmd;
sqlAd.Fill(ds, "sql");
crystalReport1.Load(Application.StartupPath + "CrystalReport.rpt");
crystalReport1.SetDataSource(ds.Tables["sql"]); //{?}中的參數可以不用賦值,即使賦了值也不起作用。
// CrystalReportSource1.ReportDocument.ParameterFields["Parm"].CurrentValues.AddValue("1234567");
crystalReport1.ParameterFields["Title"].CurrentValues.AddValue("這時推模式的報表樣例!");
crystalReportViewer1.ReportSource = crystalReport1;
}