.NET環境下水晶報表使用總結

 水晶報表是一個功能強大的報表工具，現在已經被Microsoft Visual Studio 2005（下文以VS2005簡稱）集成在一起。喜歡水晶報表的朋友可以方便使用了。我把水晶報表在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語句加上條件參數時要用{？參數名}方式給出。例：“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>
    ///功能：拉模式提取水晶報表
    ///個人主頁：http://www.dzend.com/
    ///</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=&apos;&apos;a&apos;&apos;";
        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=&apos;&apos;a&apos;&apos;";
            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;
 }

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/Jimmy2010/archive/2008/07/18/2669322.aspx