實例講解:ASP.NET水晶報表教程
報表是應用程序中不可缺少的部分,一張好的報表,能直觀地讓人把握數據的情況,對決策起到重要作用。那么,如果才能更快捷、更高效地實現報表呢?本文以一個三層結構的ASP.NET程序為例,介紹如何使用crystalreport,來制作一份報表,其中介紹了不少ASP.NET水晶報表的技巧。
在這個例子中,我們設想的應用要為一個銷售部門制作一份報表,管理者可以查看某段時間之內的銷售情況,以列表或者折線圖的形式反映出銷售的趨勢。我們將使用SQLServer 2000做為數據庫,使用VB.NET編寫中間層邏輯層,而前端的表示層使用C#。
介紹ASP.NET水晶報表教程之前,我們先來看下數據庫的結構。

其中,tbitem表中存放的是每張訂單中所訂購的貨品,tbsales存放的是每張訂單,tblsalesperson是銷售員表,存放該出版社的每位銷售員。
接下來,使用SQLServer 2000來創建這些表。表的結構如下所示:
- CREATETABLE[dbo].[tblItem](
- [ItemId][int]NOTNULL,
- [Description][varchar](50)NOTNULL
- )ON[PRIMARY]
- CREATETABLE[dbo].[tblSalesPerson](
- [SalesPersonId][int]NOTNULL,
- [UserName][varchar](50)NOTNULL,
- [Password][varchar](30)NOTNULL
- )ON[PRIMARY]
- CREATETABLE[dbo].[tblSales](
- [SaleId][int]IDENTITY(1,1)NOTNULL,
- [SalesPersonId][int]NOTNULL,
- [ItemId][int]NOTNULL,
- [SaleDate][datetime]NOTNULL,
- [Amount][int]NOTNULL
- )ON[PRIMARY]
并且用以下的代碼創建表之間的約束關系。
- ALTERTABLEtblItem
- ADDCONSTRAINTPK_ItemId
- PRIMARYKEY(ItemId)
- GO
- ALTERTABLEtblSalesPerson
- ADDCONSTRAINTPK_SalesPersonId
- PRIMARYKEY(SalesPersonId)
- GO
- ALTERTABLEtblSales
- ADDCONSTRAINTFK_ItemId
- FOREIGNKEY(ItemId)REFERENCEStblItem(ItemId)
- GO
- ALTERTABLEtblSales
- ADDCONSTRAINTFK_SalesPersonId
- FOREIGNKEY(SalesPersonId)REFERENCEStblSalesPerson(SalesPersonId)
- GO
ASP.NET水晶報表教程之創建中間邏輯層
在中間邏輯層組件中,我們為每一張表都創建兩個類。比如,對于tblItems表,創建item和items類。Item類中記錄每件銷售的貨品的詳細情況,而items表則記錄所有銷售的貨品并且有增加貨品的方法。這樣,就存在下面的六個類:
Item and Items
SalesPerson and SalesPersons
Sale and Sales
接下來,看一下每個類中的屬性:
Item類
包括如下屬性
ItemId (貨品id編號)
Description (貨品的描述)
Items
有一個方法,將根據item的編號返回一個item對象
PublicFunctionGetAllItems()AsCollections.ArrayList
SalesPerson
該類有以下三個屬性:
SalesPersonId(銷售員編號)
Name(姓名)
Password(密碼)
SalesPersons
有一個方法,根據銷售員登陸時輸入的用戶名和密碼,在數據庫中,驗證銷售員的登陸是否正確,如果正確,則返回零。
PublicFunctionValidateUser(strUserNameasString,strPasswordasString)AsInteger
Sale
有如下5個屬性
SaleId
SalesPersonId
ItemId
SaleDate
Amount
Sales
有兩個方法,其中getsales根據輸入的參數返回sales對象的集合
PublicFunctionGetSales(OptionalnSaleIdAsInteger=0,OptionalnSalesPersonIdAsInteger=0,OptionalnItemIdAsInteger=0)AsCollections.ArrayList
還有一個addsales方法,用于增加一張訂單
PublicFunctionAddSale(objSaleAsSale)
#p#
ASP.NET水晶報表教程之創建表現層頁面
接下來,開始創建表現層頁面。首先,要創建一個可以給銷售員登陸的頁面,如下圖所示。
在銷售員成功登陸后,可以給銷售員輸入某樣貨品銷售的數量,如下圖:
此外,為了給業務主管看到某個時期的銷售情況,創建如下頁面。
其中,業務主管可以選擇查看某樣貨品在某個時期(選擇開始日期,結束日期)的銷售情況,以圖表方式顯示。
這里特別值得一提的是,日歷控件的使用。在頁面中放置日歷控件后,設置如下代碼:
- <inputtype="image"onclick="Page_ValidationActive=false;"src="datepicker.gif"alt="ShowCalender"runat="server"onserverclick="ShowCal1"id="ImgCal1"name="ImgCal1">
這里設置page_validationactive參數為false,所以不需要重新提交頁面,并且,在onserverclick事件中,設置處理的代碼,如下所示:
- publicvoidShowCal1(Objectsender,System.Web.UI.ImageClickEventArgse)
- {//顯示日歷控件
- DtPicker1.Visible=true;
- }
當用戶選擇了相關的日期后,在文本框中可以獲得相關的日期:
- privatevoidDtPicker1_SelectionChanged(objectsender,System.EventArgse)
- {
- txtStartDate.Text=DtPicker1.SelectedDate.ToShortDateString();
- DtPicker1.Visible=false;
- }
在提交的頁面中,處理的代碼如下:
- privatevoidbSubmit_ServerClick(objectsender,System.EventArgse)
- {
- Response.Redirect("ViewReport.aspx?ItemId="+cboItemType.SelectedItem.Value+"&StartDate="+txtStartDate.Text+"&EndDate="+txtEndDate.Text);}
在提交頁面后,將跳轉到瀏覽報表的頁面viewreport.aspx,傳入相關的參數,如貨品ID,開始和結束日期。
ASP.NET水晶報表教程之創建報表
首先,往窗體中添加水晶報表控件,之后,就可以用水晶報表的報表設計器設計一份報表了。新建一個水晶報表文件類型,命名為itemreport.rpt,接著使用報表設計專家,并選擇設計標準型的報表,點下一步,出現如下畫面:

我們選擇使用ADO類型的數據,在彈出的窗口中,設置好sqlserver的登陸名,登陸密碼,選擇好數據庫后,選擇在報表中使用tblsales表,如下圖:
![]() |
接著選Next,在要在報表中顯示的字段中,選擇SaleDate和Amount。之后,一直選NEXT,忽略其他相關設置,***,在圖表類型中選擇折線圖,如下圖:
![]() |
***點擊finish,可以看到如下的報表:
![]() |
再次選擇報表專家,在彈出的窗口中選擇數據頁,在數據可用字段中選擇salesdate,并且可以在文本頁中,設置適當的報表標題。

由于要根據輸入的日期,貨品參數來動態顯示報表,因此我們要設置參數字段。在報表設計器中,在字段資源管理器中,選擇參數字段,鼠標右擊選擇“新建”,新建如下三個參數字段。
名稱: | 類型: |
ItemId | Number |
StartDate | Date |
EndDate | Date |
***,要設置相關的查詢公式,在除報表頁眉的區域,鼠標右鍵點擊,在彈出菜單中選擇“報表|編輯選擇公式|記錄”,輸入如下的公式:

在上面的公式編輯器中,分為左中右三部分,左邊的是報表的字段,中間的是相關的功能函數,最右邊的是運算符,雙擊其中選中的部分,則可以添加到下部的公式顯示區域中。***,保存建立的公式。
#p#
ASP.NET水晶報表教程之在程序中使用報表
接下來,我們可以在程序中用代碼處理和報表的連接過程。首先,在工程項目中,增加如下的兩個命名空間的引用(注意,在代碼中也必須用using引入它們):
- CrystalDecisions.CrystalReports.Engine
- CrystalDecisions.Shared
在viewreport.aspx的Page_load事件中,加入以下代碼
- //接收傳遞的參數
- nItemId=int.Parse(Request.QueryString.Get("ItemId"));
- strStartDate=Request.QueryString.Get("StartDate");
- strEndDate=Request.QueryString.Get("EndDate");
- //聲明報表的數據對象
- CrystalDecisions.CrystalReports.Engine.DatabasecrDatabase;CrystalDecisions.CrystalReports.Engine.TablecrTable;
- TableLogOnInfodbConn=newTableLogOnInfo();
- //創建報表對象opt
- ReportDocumentoRpt=newReportDocument();
- //加載已經做好的報表
- oRpt.Load("F:\\aspnet\\WroxWeb\\ItemReport.rpt");
- //連接數據庫,獲得相關的登陸信息
- crDatabase=oRpt.Database;
- //定義一個arrtables對象數組
- object[]arrTables=newobject[1];
- crDatabase.Tables.CopyTo(arrTables,0);
- crTable=(CrystalDecisions.CrystalReports.Engine.Table)arrTables[0];dbConn=crTable.LogOnInfo;
- //設置相關的登陸數據庫的信息
- dbConn.ConnectionInfo.DatabaseName="WroxSellers";dbConn.ConnectionInfo.ServerName="localhost";
- dbConn.ConnectionInfo.UserID="sa";
- dbConn.ConnectionInfo.Password="test";
- //將登陸的信息應用于crtable表對象
- crTable.ApplyLogOnInfo(dbConn);
- //將報表和報表瀏覽控件綁定
- crViewer.ReportSource=oRpt;
- //傳遞參數
- setReportParameters();
在上面的代碼中,首先接收了日期,貨品編號等參數,并實例化了Database,Table和TableLogOnInfo三個類,它們是用來在運行時,建立報表和數據庫的連接必需的。再使用
oRpt.Load("F:\\aspnet\\WroxWeb\\ItemReport.rpt");
來裝載已經做好了的報表。
在裝載完報表后,將數據庫中要使用的表復制到一個對象數組中去,并選擇對象數組中的***個表元素,將其轉換為水晶報表的報表對象。接著,再設置LOGONINFO中的登陸數據庫的信息。***,將報表源與報表瀏覽控件綁定。
#p#
ASP.NET水晶報表教程之傳遞參數到ASP.NET水晶報表
定義一個新的過程,setReportParameters(),代碼如下:
- privatevoidsetReportParameters()
- {
- //alltheparameterfieldswillbeaddedtothiscollection
- ParameterFieldsparamFields=newParameterFields();
- //theparameterfieldstobesenttothereport
- ParameterFieldpfItemId=newParameterField();
- ParameterFieldpfStartDate=newParameterField();
- ParameterFieldpfEndDate=newParameterField();
- //設置在報表中,將要接受的參數字段的名稱
- pfItemId.ParameterFieldName="ItemId";
- pfStartDate.ParameterFieldName="StartDate";
- pfEndDate.ParameterFieldName="EndDate";
- ParameterDiscreteValuedcItemId=newParameterDiscreteValue();
- ParameterDiscreteValuedcStartDate=newParameterDiscreteValue();ParameterDiscreteValuedcEndDate=newParameterDiscreteValue();
- dcItemId.Value=nItemId;
- dcStartDate.Value=DateTime.Parse(strStartDate);
- dcEndDate.Value=DateTime.Parse(strEndDate);
- pfItemId.CurrentValues.Add(dcItemId);
- pfStartDate.CurrentValues.Add(dcStartDate);pfEndDate.CurrentValues.Add(dcEndDate);
- paramFields.Add(pfItemId);
- paramFields.Add(pfStartDate);
- paramFields.Add(pfEndDate);
- //將參數集合綁定到報表瀏覽控件
- crViewer.ParameterFieldInfo=paramFields;
- }
現在來解釋一下上面的代碼。在水晶報表中,瀏覽器控件有一個屬性parameterfieldsinfo,該屬性可以通過綁定parameterfields類型的集合,將相關的參數的實際數值傳遞到報表。Parameterfields類型集合通過add的方法,接收Parameterfield類型的對象。因此,我們先為itemid,startdate,enddate三個參數創建parameterfield類型的對象,并且設置它們對應報表中接受參數的名稱:
- ParameterFieldsparamFields=newParameterFields();
- ParameterFieldpfItemId=newParameterField();
- ParameterFieldpfStartDate=newParameterField();
- ParameterFieldpfEndDate=newParameterField();
- //設置在報表中,將要接受的參數字段的名稱
- pfItemId.ParameterFieldName="ItemId";
- pfStartDate.ParameterFieldName="StartDate";
- pfEndDate.ParameterFieldName="EndDate";
接著,可以為這些參數字段設置具體的值了,但由于parameterfield必須接受ParameterDiscreteValue類型的對象,所以,再創建相關的實例:
- ParameterDiscreteValuedcItemId=newParameterDiscreteValue();
- ParameterDiscreteValuedcStartDate=newParameterDiscreteValue();
- ParameterDiscreteValuedcEndDate=newParameterDiscreteValue();
- dcItemId.Value=nItemId;
- dcStartDate.Value=DateTime.Parse(strStartDate);
- dcEndDate.Value=DateTime.Parse(strEndDate);
***,就可以在三個parameterfield的對象中的currentvalues中設置它們的值,并往paramFields集合中加進這三個parameterfield對象。
運行的結果如下。
![]() |
以上ASP.NET水晶報表教程相關程序在VS.NET2003,crystalreport9以上版本可以正確運行。
【編輯推薦】
- 淺談ASP.NET報表控件
- 概述ASP.NET水晶報表
- VS.Net中的水晶報表的應用
- VS.NET 2002下水晶報表的安裝與部署
- ASP.NET 2.0部署WEB應用程序淺析
- ASP.NET中的數據源控件