【.NET 水晶報表的使用實例 - [c#.net]】
【說明】
水晶報表在應用時分兩種方法，分別是拉模式（PULL）、推模式（PUSH）。
拉模式：在水晶報表生成時的數據源是從水晶報表文件中的SQL語句從數據庫中提取的，在編程時不用重寫SQL語句，但要加上登錄信息（具體方法，後面介紹）。
推模式：在水晶報表生成時的數據源，是用編程時重寫水晶報表中SQL語句而生成的dataset對像。也就是說，推模式是用dataset組裝水晶報表。
水晶報表組件介紹。水晶報表在VS2005中有兩種組件，在WEB項目是分別是CrystalReportSource，CrystalReportViewer。在FORM項目裏是分別是crystalReport，CrystalReportViewer。
CrystalReportSource，crystalReport是水晶報表的數據提供者；CrystalReportViewer是水晶報表的瀏覽器。另外還要介紹一下水的報表的文件是以rpt爲擴展名的文件，該文件可以用VS2005生成。
下面分別介紹具體操作方法：
拉模式（PULL）：
在拉模式中如要在水晶報表中的SQL語句加上條件參數時要用{？參數名}方式給出。例：“Select T1, T2, T3 FROM T Where T1=''{?parm}''” parm就是參數名
以下例子中所用到的水晶報表文件中使用的SQL語句是“Select T1, 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>
protected void 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()方法。
private void 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;
protected void Button_push_Click(object sender, EventArgs e)
{
string sql = "Select T1, T2, T3 FROM T where T1=''a''";
string DBConfig_sql =@"Data Source=SYWZSWL\SQLEXPRESS;Initial Catalog=Test;User ID=sa;Password=123456";
DataSet ds = new DataSet();
SqlConnection sqlCon = new SqlConnection(DBConfig_sql);
SqlCommand sqlCmd = new SqlCommand(sql, sqlCon);
SqlDataAdapter sqlAd = new SqlDataAdapter();
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方式下】
private void Form1_Load(object sender, EventArgs e)
{
//推模式
string sql = "Select T1, T2, T3 FROM T where T1=''a''";
string DBConfig_sql = @"Data Source=SYWZSWL\SQLEXPRESS;Initial Catalog=Test;User ID=sa;Password=123456";
DataSet ds = new DataSet();
SqlConnection sqlCon = new SqlConnection(DBConfig_sql);
SqlCommand sqlCmd = new SqlCommand(sql, sqlCon);
SqlDataAdapter sqlAd = new SqlDataAdapter();
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;
}
--------------------------------------------------------------------------------------------------------------------------
命名空間
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
實例1 自動載入
//定義報表對象
ReportDocument rpt = new ReportDocument();
*()
{
//>.1.設置報表文件載入>>>>>>>>>>
string rptFile = path_rpt + RPT + ".rpt";
rpt.Load(rptFile);
//>.2.設置報表數據庫連接>>>>>>>>>>
this.SetDB(DB);
//rpt.SetDatabaseLogon(db_User, db_Password, db_Server, db_Database);
rpt.SetDatabaseLogon(db_User, db_Password);
//>.3.構建報表參數>>>>>>>>>>>>>>>>>
ParameterFields parameters = new ParameterFields();
ParameterField parameter = new ParameterField();
ParameterDiscreteValue discrVal = new ParameterDiscreteValue(); //離散值參數
ParameterRangeValue rangeVal = new ParameterRangeValue(); //區間值參數
//參數個數
int Ps = Convert.ToInt32(Ptotal);
if (Ps == 0)
{
rpt.Refresh();
}
if (Ps > 0)
{
string[] PsV = PV.Trim().Split('?');
for (int p = 1; p <= Ps; p++)
{
string[] pValues = PsV[p].Trim().Split('|');
if (pValues[1].Trim() == "S") //判斷參數類型
{
parameter.Name = pValues[0].Trim();
rangeVal.StartValue = pValues[2].Trim().Split(':')[0].Trim();
rangeVal.EndValue = pValues[2].Trim().Split(':')[1].Trim();
parameter.CurrentValues.Add(rangeVal);
parameters.Add(parameter);
rpt.ParameterFields[pValues[0].Trim()].CurrentValues = parameters[pValues[0].Trim()].CurrentValues;
}
if (pValues[1].Trim() == "D")
{
parameter.Name = pValues[0].Trim();
discrVal.Value = pValues[2].Trim();
parameter.CurrentValues.Add(discrVal);
parameters.Add(parameter);
rpt.ParameterFields[pValues[0].Trim()].CurrentValues = parameters[pValues[0].Trim()].CurrentValues;
}
}
}
//>.4.報表文件輸出>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
string PDF_file = path_PDF + RPT + ".pdf";
string XLS_file = path_XLS + RPT + ".xls";
if (ExtFormat == "P")
{
try
{
rpt.ExportToDisk(CrystalDecisions.Shared.ExportFormatType.PortableDocFormat, PDF_file);
}
catch
{
MessageBox.Show("執行[" + RPT + "]出現異常，請在程序完後續報表後，改爲手動執行該報表！");
}
}
if (ExtFormat == "X")
{
try
{
rpt.ExportToDisk(CrystalDecisions.Shared.ExportFormatType.Excel, XLS_file);
}
catch
{
MessageBox.Show("執行[" + RPT + "]出現異常，請在程序完後續報表後，改爲手動執行該報表！");
}
}
if (ExtFormat == "PX")
{
try
{
rpt.ExportToDisk(CrystalDecisions.Shared.ExportFormatType.Excel, XLS_file);
rpt.ExportToDisk(CrystalDecisions.Shared.ExportFormatType.PortableDocFormat, PDF_file);
}
catch
{
MessageBox.Show("執行[" + RPT + "]出現異常，請在程序完後續報表後，改爲手動執行該報表！");
}
}
//>.5.關閉當前報表>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
rpt.Close();
}
實例2 手動載入
//載入水晶報表
rpt.Load(rpt_file);
//設置數據庫登錄
//rpt.SetDatabaseLogon(db_User, db_Password, db_Server, db_Database);
rpt.SetDatabaseLogon(db_User, db_Password);
if (rpt.DataDefinition.ParameterFields.Count == 0)
{
rpt.Refresh(); //刷新無參數報表文件
}
//分析報表參數///?????????????????????????????????????????????????????????????????????????
if (rpt.DataDefinition.ParameterFields.Count > 0)
{
string parameters = "";
int c = rpt.DataDefinition.ParameterFields.Count;
for (int i = 1; i <= c; i++)
{
parameters += "參數-" + i.ToString()
+ "[" + rpt.DataDefinition.ParameterFields[i - 1].ParameterValueKind.ToString() + "]: "
+ rpt.DataDefinition.ParameterFields[i - 1].ParameterFieldName
+ " / ";
}
listBox1.Items.Add(parameters);
listBox1.SelectedIndex = listBox1.Items.Count - 1;
this.crystalReportViewer1.RefreshReport();
}
-------------
By Kimi