创建、加载和呈现报表讲述.docx

创建、加载和呈现报表尽管你会在桌面和Web的多种不同场景下使用C1Report，但主要的步骤都是相同的：创建一个报表定义你可以直接使用C1Report设计器应用程序创建，也可以在Microsoft Access中使用报表设计器创建，然后将它导出到C1Report设计器中。还可以使用代码完成，使用对象模型添加组、字段，或编写一个自定义的XML文件。在C1Report组件中加载报表在设计时，使用“LoadReport”上下文菜单，或以编程方式使用Load方法完成报表加载。如果在设计时完成报表加载，在控件中它会变为“持久的”（被保存），你将不再需要分发报表定义文件。呈现报表（桌面应用程序）如果你在开发一个桌面应用程序，可以轻松在C1PrintPreview控件里呈现报表。预览控件在屏幕上显示报表，用户能够以完全放大、平移的方式预览它。例如：VisualBasicC1PrintPreview1.Document = c1rC#c1printPreview1.Document= c1r;呈现报表（Web应用程序）如果你在开发一个Web应用程序，可以使用RenderToFile方法在HTML或PDF文件中呈现报表，用户可以使用任意浏览器查看它们。创建一个报表定义以下主题将为您展示如何使用C1ReportDesigner应用程序或代码创建一个报表定义。注意创建报表定义与呈现报表不同。当呈现报表时，你只需加载一个已有的定义并调用Render方法。使用C1ReportDesigner创建一个报表定义创建报表定义最简单的方法就是使用C1ReportDesigner应用程序，它是一个独立的应用程序，类似于Microsoft Access中的报表设计器。C1Report Wizard会从开始步骤到结束步骤引导你创建一个新的报表。关于创建新报表步骤的更多信息，请查看“创建一个基本报表定义”。使用代码创建一个报表定义你还可以从头开始使用代码创建报表。此方案需要一些额外的工作量，但它非常灵活。你甚至可以编写自己的报表设计器或专门报表生成器。以下示例使用代码创建了一个基于NorthWind数据库的简单列表报表定义。代码添加了注释，说明了C1Report对象模型的最重要的元素。完成下列步骤：首先，在表单中添加一个button控件、C1Report 组件和C1PrintPreview控件。设置以下属性：Button.Name = btnEmployeesC1Report.Name = c1r C1PrintPreview.Name = ppv初始化控件，起名为c1r，使用Clear方法清除它的内容，并设置控件字体（指定新字段的字体）：Visual Basic Private Sub RenderEmployees() With c1r ' 清除任何已有的字段.Clear() ' 为所有控件设置默认字体.Font.Name = "Tahoma" .Font.Size = 8 End With C# private void RenderEmployees() { // 清除任何已有的字段c1r.Clear(); // 为所有控件设置默认字体c1r.Font.Name = "Tahoma"; c1r.Font.Size = 8; } 接下来，设置DataSource 对象，从NorthWind数据库检索你想要的数据。使用ConnectionString 和RecordSource属性完成（类似 Microsoft ADO DataControl）：Visual Basic ' 初始化数据源With c1r.DataSource .ConnectionString = "Provider=Microsoft.Jet.OLEDB.4.0;" & _ "Data Source=C:\…\ComponentOne Samples\Common\Nwind.mdb;" & _ "Persist Security Info=False" .RecordSource = "Employees" End With C# // 初始化数据源DataSourceds = c1r.DataSource; ds.ConnectionString = @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\…\ComponentOne Samples\Common\Nwind.mdb;"; ds.RecordSource = "Employees"; 接下来，初始化Layout对象，它定义了报表在页面上的布局方式。在此示例中，纵向呈现报表，将宽度设为6.5英寸（8.5英尺的页宽减去两侧一英尺的边距）：Visual Basic ' 初始化布局With