介紹
任何數據驅動型的應用程序都有一個普遍的需求,那就是報表。 但是,在ASP.NET 1.x中並沒有給我們提供這個非常重要的特性。 然而很幸運的是,伴隨着.NET 2.0而來的ReportViewer控件可以滿足你對報表的一些基本需求。 我將會在本文中向你演示如何使用這個控件。 ReportViewer控件既可以在web程序中使用,也可以在windows程序中使用。 在這裏,我將只介紹如何在web程序中使用它。
報表示例
我們假設要生成一個如下所示的顧客信息列表:
上面的報表是一個非常簡單的以國家分組的顧客信息列表。 報表的數據是從Northwind數據庫的Customers表裏獲取的。 默認情況下,它會顯示所有的顧客信息。 但是,你也可以讓它顯示屬於你指定的某個國家的顧客信息。
該報表是使用ReportViewer控件設計的,它可以從強類型的DataSet中或者自定義的對象集合中獲取數據。 在實際的程序開發中,我們往往會使用3層架構,數據的獲取經常會是從業務層取得的DataSet或一個泛型集合。 在這裏,我打算使用一個泛型集合作爲數據源,而不是強類型的DataSet。
創建類庫
首先,打開Visual Studio,然後創建一個名爲ReportViewerLib的類庫項目。 添加一個如下所示的名爲Customer的類:
using System; using System.Data; using System.Configuration; using System.Data.SqlClient; using System.Collections.Generic; namespace ReportViewerLib { public class Customer { public string strCustomerID; public string strCompanyName; public string strContactName; public string strCountry; public string CustomerID { get { return strCustomerID; } set { strCustomerID = value; } } public string CompanyName { get { return strCompanyName; } set { strCompanyName= value; } } public string ContactName { get { return strContactName; } set { strContactName= value; } } public string Country { get { return strCountry; } set { strCountry= value; } } public static List { SqlConnection cnn=new SqlConnection( ConfigurationManager.ConnectionStrings["NorthwindConnectionString"].ConnectionString); SqlCommand cmd=new SqlCommand(); cmd.Connection=cnn; cmd.CommandText="select CustomerID,CompanyName,ContactName,Country from customers where country=@country"; SqlParameter p=new SqlParameter ("@country",country); cmd.Parameters.Add(p); cnn.Open(); SqlDataReader reader = cmd.ExecuteReader(); List while (reader.Read()) { Customer c = new Customer(); c.CustomerID = reader.GetString(0); c.CompanyName = reader.GetString(1); c.ContactName = reader.GetString(2); c.Country = reader.GetString(3); list.Add(c); } cnn.Close(); return list; } public static List { SqlConnection cnn = new SqlConnection( ConfigurationManager.ConnectionStrings ["NorthwindConnectionString"].ConnectionString); SqlCommand cmd = new SqlCommand(); cmd.Connection = cnn; cmd.CommandText = "select CustomerID,CompanyName,ContactName,Country from customers"; cnn.Open(); SqlDataReader reader = cmd.ExecuteReader(); List while (reader.Read()) { Customer c = new Customer(); c.CustomerID = reader.GetString(0); c.CompanyName = reader.GetString(1); c.ContactName = reader.GetString(2); c.Country = reader.GetString(3); list.Add(c); } cnn.Close(); return list; } } } |
Customer類定義了四個公共屬性,即CustomerID、CompanyName、ContactName和Country。 在之後,是這個類包含的兩個靜態方法 – GetCustomersForContry()和GetAllCustomers()。 這兩個方法都是比較簡單的,一個是返回屬於某一個國家的所有顧客信息,另一個是返回全部顧客信息。 首先打開Northwind數據庫的連接,然後通過SqlCommand對象執行SELECT查詢。 之後,用SqlDataReader對象來獲取數據。 遍歷這個SqlDataReader對象,在其內每次都創建一個Customer對象,然後設置它的各個屬性,最後把其添加到Customer對象的泛型集合中。 在類的結尾處就是把這個Customer對象的泛型集合返回給調用者。
創建數據源
設計報表的時候,需要在你的項目中爲其指定一個數據源。 在你的項目中添加一個數據源可以這樣做,選擇“數據”菜單 -> 添加新數據源。 然後將會出現如下圖所示的對話框:
你的數據源可以是數據庫、web service或者是一個對象。 本例中我們選擇的是對象。 然後單擊“下一步”按鈕,會彈出讓我們選擇數據源的界面。 我們選擇的是Customer類(如下圖所示)。
單擊“完成”按鈕後就完成了數據源配置嚮導。 這樣,你就在你的類庫中添加了一個新的數據源。 如果要查看數據源的話可以這麼做,選擇“數據”菜單 -> 顯示數據源,就會出現如下圖所示的界面:
設計報表
接下來添加一個報表。 右鍵單擊項目,選擇“添加新項”。 在對話框裏選擇“報表”,並單擊“添加”按鈕(如下圖所示)。 這樣,我們就添加了一個名爲“Report1.rdlc”的文件。 .rdlc文件是一個報表文件,它保存的是報表佈局和數據映射。
一旦你打開了Report1.rdlc文件,Visual Studio的工具箱裏就會顯示出一套與報表相關的控件(如下所示)。
這些控件中,“文本框”控件和“表”控件是非常常用的。 “文本框”控件用於顯示一段靜態文本或者是一個表達式。 “表”控件用於顯示錶格數據,其生成的結果會顯示在你的報表的“主體”中。
設計出的報表如下圖所示:
在報表的“頁眉”部分的頭部,有一個文本框,其Value屬性的值爲“Customer Listing”。 在這個文本框的下面還有另一個文本框,其Value屬性的值爲“=Parameters!SubTitle.Value”。它的意思就是指明文本框的值來自名爲SubTitle的參數。 我們如何來定義參數呢? 這需要在報表的ReportParameters屬性中添加參數。 打開的報表參數對話框如下圖所示:
請注意:參數的設置是在我們的.NET代碼中完成的。
如果要在報表上顯示日期的話,只要設置相關的文本框的Value屬性爲“=FormatDateTime(ToDay(),DateFormat.ShortDate)”即可。 報表的一大優勢就是有很多的內置函數,如ToDay()和FormatDateTime之類的。 本例中,我們使用FormatDateTime()函數來以ShortDate的格式顯示當前的日期(ToDay())。
現在,從工具箱裏拖拽一個“表”控件到你的報表上。 默認情況下,“表”控件有3行3列,3行分別是:表頭、詳細信息和表尾。 當然,你也可以爲“表”控件添加行和列。 從數據源窗口中拖拽CustomerID、CompanyName、ContactName和Country屬性到你的“表”控件的詳細信息行上。 這樣,系統將會自動地添加文本框,並設置其屬性爲=Fields!CustomerID.Value、=Fields!CompanyName.Value之類的。 此時,列頭也會被自動地添加。 當然,你也可以根據你的需求做你需要的修改。
接下來,我們要按顧客所屬的國家對記錄進行分組。 右鍵單擊詳細信息行的邊框,選擇插入組(如下圖所示)。
然後將會出現如下圖所示的對話框:
在“排序”選項卡中選擇“=Fields!Country.Value”作爲表達式,選擇“Ascending”作爲排序方向。
就是這些東西,很簡單吧。 這樣,我們就完成了報表的設計。
顯示報表
新建一個名爲“ReportViewerDemo”的web站點。 添加ReportViewerLib程序集的引用,這樣該程序集就會拷貝到你的web站點的BIN目錄下。 之後,把Report1.rdlc文件添加到你的web站點中。 在工具箱的“數據”選項卡中拖拽一個ReportViewer控件到你的Default.aspx頁上, 打開ReportViewer控件的智能標記面板,在“選擇報表”的下拉框中選擇Report1.rdlc,如下圖所示:
選擇好報表文件後,系統會自動地添加一個TypeName屬性爲Customer的對象數據源控件。 你可以在對象數據源控件的配置嚮導中驗證一下。
接下來,拖拽一個DropDownList控件到頁的頭部,併爲其設置4個選項 – All、USA、UK和Brazil。 同時設置它的AutoPostBack屬性爲True。 然後,打開數據源控件的配置嚮導,設置“SELECT”操作爲SelectCustomersForCountry()方法。
設置SelectCustomersForCountry()方法的country參數爲DropDownList1的SelectedValue。
默認情況下,將在報表中顯示所有顧客信息。 當你在DropDownList選擇了一個國家的時候,報表中就會顯示屬於你所選擇的國家的顧客信息。 要完成這樣的功能,我們只需要處理DropDownList的SelectedIndexChanged事件。
protected void DropDownList1_SelectedIndexChanged (object sender, EventArgs e) { if (DropDownList1.SelectedValue == "All") { ObjectDataSource1.SelectMethod = "GetAllCustomers"; ObjectDataSource1.SelectParameters.Clear(); ReportParameter param = new ReportParameter ("SubTitle", "List of all the customers"); ReportParameter[] p ={ param }; ReportViewer1.LocalReport.SetParameters(p); } else { ObjectDataSource1.SelectMethod = "GetCustomersForCountry"; ObjectDataSource1.SelectParameters[0].DefaultValue = DropDownList1.SelectedValue; ReportParameter param = new ReportParameter ("SubTitle", "List of customers for a country"); ReportParameter[] p ={ param }; ReportViewer1.LocalReport.SetParameters(p); } } |
這段代碼首先檢查DropDownList控件的SelectedValue屬性。 如果是“All”的話就設置數據源控件的SelectMethod屬性爲GetAllCustomers。 另外,我們還需要清空SelectParameters集合,因爲GetAllCustomers()方法不需要任何參數。 接下來,我們創建一個ReportParameter類的實例,並在其構造函數中設置報表的參數名和參數值。 回憶一下我們在設計報表時定義的參數。 然後再創建一個ReportParameter數組。 調用SetParameters()方法,並用這個數組作爲其參數。 “else”代碼塊也是非常地簡單,就是使用的方法變成了GetCustomersForCountry()而已。
就是這些東西,很簡單吧。 報表已經搞定了。 你可以運行一下Default.aspx頁看看效果。 注意,ReportViewer控件已經內置了導出特性,它允許你把報表導出爲Excel或PDF格式。 ReportViewer控件還很多的屬性,你可以自己摸索一下。
總結
ASP.NET的ReportViReportViewer控件提供了很多報表的基本功能。 在本文中,我們使用了對象數據源控件來開發一個報表。 我們創建了一個類庫和一個數據源。 最後使用ReportViewer控件來顯示報表。