水晶 表教程

【说明】
水晶 表在应用时分两种方法，分别是拉模式（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=”{arm}”” parm就是参数名

以下例子中所用到的水晶 表文件中使用的SQL语句是“Select T1, T2, T3 FROM T Where T1=”{arm}”” 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;