【.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;
///
///功能:拉模式提取水晶报表
///
///
///
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