有時候，將ActiveReports設計器集成到業務系統中，為用戶提供一些自定義的數據表，用戶不需要了解如何底層的邏輯關系和后台代碼，只需要選擇幾張關聯的數據表，我們會根據用戶的選擇生成可供用戶直接使用的數據集。本文第一部分主要講解了，如何構造三種報表模板，第二部分主要講解了對於DataRelation類在動態綁定數據集之間的用法。
首先需要構造LayoutBuilder類，該類主要構造三種類型的報表以及為它們添加數據集字段。
1. 創建RDL 報表
使用PageReport對象，並添加屬性
public static void BuildRdlReportLayout(Design.Designer designer) { PageReport report = new PageReport(); report.Report.Body.Height = "5cm"; report.Report.Width = "20cm"; report.Load(new StringReader(report.ToRdlString())); //report = LayoutBuilder.AddDataSetDataSource(report);//Adding DataSources to the PageReport object report = LayoutBuilder.addDataSet(report); MemoryStream reportStream = LayoutBuilder.LoadReportToStream(report);//Loading the PageReport object to a stream reportStream.Position = 0; designer.LoadReport(XmlReader.Create(reportStream), DesignerReportType.Page); }
2. 創建頁面報表
頁面報表使用頁面報表的構造字符串的方式來創建，否則會默認生成RDL報表
// 創建頁面報表 public static void BuildPageReportLayout(Design.Designer designer) { PageReport report = new PageReport(); report.Load(new StringReader( @"<Report xmlns=""http://schemas.microsoft.com/sqlserver/reporting/2005/01/reportdefinition""> <Body> <Height>27.9cm</Height> <ReportItems> <FixedPage Name=""FixedPage1""> <Pages> <Page /> </Pages> </FixedPage> </ReportItems> </Body> <BottomMargin>2.5cm</BottomMargin> <LeftMargin>2.5cm</LeftMargin> <PageHeight>27.9cm</PageHeight> <PageWidth>21.6cm</PageWidth> <RightMargin>2.5cm</RightMargin> <TopMargin>2.5cm</TopMargin> <Width>21.6cm</Width> </Report>")); report = LayoutBuilder.AddDataSetDataSource(report);//Adding DataSources to the PageReport object MemoryStream reportStream = LayoutBuilder.LoadReportToStream(report);//Loading the PageReport object to a stream reportStream.Position = 0; designer.LoadReport(XmlReader.Create(reportStream), DesignerReportType.Page); }
3. 頁面報表和RDL添加數據方法
因為頁面報表和RDL報表從代碼級別而言，是相同的，都被視為PageReport，所以對於頁面報表和RDL報表執行的類和接口也都相同。
添加數據集采用的是綁定預先設計的字段，因為在使用過程中用戶只需要使用現成的數據來設計報表，所以我們需要為報表預先綁定好可以使用的字段，代碼如下：
public static PageReport AddDataSetDataSource(PageReport report) { // create DataSource for the report DataSource dataSource = new DataSource(); dataSource.Name = "Reels Database"; dataSource.ConnectionProperties.DataProvider = "DATASET"; dataSource.ConnectionProperties.ConnectString = ""; //Create DataSet with specified query and load database fields to the DataSet DataSet dataSet = new DataSet(); Query query = new Query(); dataSet.Name = "Sample DataSet"; query.DataSourceName = "Reels Database"; query.CommandType = QueryCommandType.Text; query.CommandText = ""; dataSet.Query = query; String[] fieldsList = new String[] { "MoviedID", "Title", "YearReleased", "MPAA" }; foreach (string fieldName in fieldsList) { Field field = new Field(fieldName, fieldName, null); dataSet.Fields.Add(field); } //create report definition with specified DataSet and DataSource report.Report.DataSources.Add(dataSource); report.Report.DataSets.Add(dataSet); return report; }
4. 創建區域報表及添加數據：
區域報表的創建方式與頁面報表類似，采用字符串讀取的形式，並直接添加數據字段。
public static void BuildSectionReportLayout(Design.Designer designer) { // 空白區域報表 string rpx = "<?xml version=\"1.0\" encoding=\"utf-8\"?> <ActiveReportsLayout Version=\"3.2\" PrintWidth=\"9360\" DocumentName=\"ActiveReports Document\" ScriptLang=\"C#\" MasterReport=\"0\"> <StyleSheet> <Style Name=\"Normal\" Value=\"font-family: Arial; font-style: normal; text-decoration: none; font-weight: normal; font-size: 10pt; color: Black; text-align: left; vertical-align: top; ddo-char-set: 1\" /> <Style Name=\"Heading1\" Value=\"font-family: Arial; font-size: 16pt; font-style: normal; font-weight: bold\" /> <Style Name=\"Heading2\" Value=\"font-family: Times New Roman; font-size: 14pt; font-style: italic; font-weight: bold\" /> <Style Name=\"Heading3\" Value=\"font-family: Arial; font-size: 13pt; font-style: normal; font-weight: bold\" /> </StyleSheet> <Sections> <Section Type=\"PageHeader\" Name=\"PageHeader1\" Height=\"360\" BackColor=\"16777215\" /> <Section Type=\"Detail\" Name=\"Detail1\" Height=\"2880\" BackColor=\"16777215\" /> <Section Type=\"PageFooter\" Name=\"PageFooter1\" Height=\"360\" BackColor=\"16777215\" /> </Sections> <ReportComponentTray /> <PageSettings /> <Parameters /> </ActiveReportsLayout>"; // 區域報表數據源結構 System.Data.DataTable dt = new System.Data.DataTable(); dt.Columns.Add("Col1"); dt.Columns.Add("Col2"); dt.Columns.Add("Col3"); designer.Report = null; // 加載區域報表到設計器 designer.LoadReport(XmlReader.Create(LayoutBuilder.CovertStringToStream(rpx)), DesignerReportType.Section); // 設置區域報表數據源 SectionReport sr2 = designer.Report as SectionReport; sr2.DataSource = dt; }
5. 修改ReportsForm_Load 方法
LayoutBuilder.BuildRdlReportLayout(this.reportDesigner);
這樣打開設計器之后，則會呈現帶字段的數據集，當用戶可以直接使用數據集字段，設計滿足需求的報表了，當用戶設計完成可能需要預覽報表，這樣就需要為報表返回實際的數據了。
首先在報表設計器中添加“預覽”按鈕
// 添加預覽報表菜單 fileMenu.DropDownItems.Add(new ToolStripMenuItem("預覽", null, new EventHandler(OnViewReport)));
實現預覽方法，將當前設計的報表傳給ReportViewer：
private void OnViewReport(object sender, EventArgs e) { ReportViewer viewer = new ReportViewer(); viewer.Report = reportDesigner.Report; viewer.ReportType = reportDesigner.ReportType; viewer.ShowDialog(); }
獲取到保鏢對象后，通過LocateDataSource來綁定字段：
switch (ReportType) { case DesignerReportType.Page: PageReport report1 = Report as PageReport; viewer1.LoadDocument(report1.Document); break; case DesignerReportType.Rdl: PageReport report2 = Report as PageReport; PageDocument reportD = new PageDocument(report2); reportD.LocateDataSource += new LocateDataSourceEventHandler(LoadDataSet); viewer1.LoadDocument(reportD); break;
其中我們在DataSet中使用了DataRelation 對象，用來創建Table之間的關系，但是AR對DataRelation的支持只限於父級數據的訪問。
訪問父數據表的字段時，字段的前綴應該為合適的數據表的關系名稱，使用“.”進行分割。舉例說明，有一個數據表OrderDetails作為子表關聯到數據表Orders,兩個數據表之間的關系名稱為Orders_OrderDetails。可以使用下面的語法訪問父數據表的字段OrderDate：Orders_OrderDetails.OrderDate
使用同樣的語法可以訪問嵌套多層的數據表字段。如，上例中的數據表Orders也存在父數據表Customers，關系名稱為Customers_orders。命令行文本中指定數據表OrderDetails為主表，使用下面的語法訪問父數據表的字段CustomerName：Customers_Orders.Orders_OrderDetails.CustomerName
注：當字段名稱和關系使用相同名稱時會發生錯誤，暫時不支持。
private void LoadDataSet(object sender, LocateDataSourceEventArgs args) { string constr = @"Provider=sqloledb; password=xA123456;data source=10.32.2.28;initial catalog=NWind_CHS;user id=sa;"; //此處修改為AR的測試數據庫 // 創建DataSet DataSet myDataSet = new DataSet(); //string connStr = Properties.Resources.ConnectionString; OleDbConnection conn = new OleDbConnection(constr); DataTable[] myDataTables = new DataTable[3]; myDataTables[0] = new DataTable(Constants.SaleTableName); myDataTables[1] = new DataTable(Constants.SaleDetailsTableName); myDataTables[2] = new DataTable(Constants.CustomerTableName); //創建DataTable myDataSet.Tables.Add(myDataTables[0]); OleDbCommand cmd1 = new OleDbCommand(Constants.cmdText1, conn); OleDbDataAdapter oleAdapter1 = new OleDbDataAdapter(cmd1); oleAdapter1.Fill(myDataSet.Tables[0]); //為Table 添加數據 myDataSet.Tables.Add(myDataTables[1]); OleDbCommand cmd2 = new OleDbCommand(Constants.cmdText2, conn); OleDbDataAdapter oleAdapter2 = new OleDbDataAdapter(cmd2); oleAdapter2.Fill(myDataSet.Tables[1]); //為Table 添加數據 myDataSet.Tables.Add(myDataTables[2]); OleDbCommand cmd3 = new OleDbCommand(Constants.cmdText3, conn); OleDbDataAdapter oleAdapter3 = new OleDbDataAdapter(cmd3); oleAdapter3.Fill(myDataSet.Tables[2]); //創建 “DataRelation Customers_Orders” DataRelation Customers_Orders = new DataRelation("C_O",myDataSet.Tables[2].Columns["客戶ID"], myDataSet.Tables[0].Columns["客戶ID"] ); myDataSet.Relations.Add(Customers_Orders); //創建 “DataRelation ” DataRelation Orders_OrderDetails = new DataRelation("O_OD ", myDataSet.Tables[0].Columns["訂單ID"], myDataSet.Tables[1].Columns["訂單ID"]); myDataSet.Relations.Add(Orders_OrderDetails); //返回從表數據 args.Data = myDataSet.Tables[0];
到這里本篇內容就已經講述完了，主要對於開發CRM系統的一些用戶數據處理，和如何綁定到報表中進行了講述，希望對大家有所幫助。
Demo 下載