使用C1Report控件

您可以在各种不同的编程场景使用C1Report，包括Desktop桌面应用和Web应用。使用的步骤在不同平台下是完全一致的：

1.首先使用C1ReportDesigner程序创建并定义一个报表，报表的定义描述将保存在XML文件中。您可以从头创建一个全新的报表，或者从一个现有的Microsoft Access报表导入一个现有的报表。之后您可以使用C1ReportDesigner基于现有报表进行修改。

2. C1Report组件将读取该报表并使用来自于任何标准的.NET数据源的数据呈现该报表。 3.可以在设计时加载一个预先定义的报表，并将其嵌入您的应用程序中，或者您也可以在运行时读取并修改一个现有报表。（同样您也可以使用C1Report对象模型，从头开始创建一个全新的报表。）

4.报表可以直接打印到打印机，呈现到一个C1PrintPreview控件上，或者可以输出到HTML或者PDF文件，之后可以直接发布到Web页面上。

下图显示了ComponentOne Reports for WinForms组件包中各个组件间的关系：

注：下图中具有粗边框的方框表示具有代码逻辑的组件（比如控件以及应用程序）。具有细边框的方框表示包含信息的文件（报表定义、数据以及完成的报表）。

以下数字表示图中对应的箭头的编码，这些箭头用来表示组件之间的关系： 1.使用C1ReportDesigner应用程序创建、编辑并保存XML格式的报表定义文件。

2. C1Report组件从设计器创建的XML文件加载定义的报表。既可以在设计时完成加载（这种情况下，XML文件将直接应用到控件的设置上，运行时不再需要引用该文件）也可以通过Load方法在运行时加载。

3. C1Report组件从数据源加载数据，数据源由报表定义文件指定。同时，您也可以提供自定义的数据源。

4. C1Report组件按照报表定义格式化数据并将报表呈现至（a）打印机，（b）一种或者多种格式的文件，或者（c）一个打印预览控件。

5.应用程序可以通过丰富的对象模型和C1Report组件进行交互，您可以容易的自定义报表或者生成全新的报表。C1ReportDesigner就是实现了类似功能的一个很好的例子。

对象模型概述

C1Report组件的对象模型主要基于Microsoft Access的模型，所不同的是Access具有不同的控件类型（标签控件，文本框控件，线形控件等等），而C1Report仅支持一个Field对象，该Field对象可以通过设置属性使得其看起来像是一个标签、文本框、线、图片、子报表等等。 下表列举了全部的对象，以及其主要的属性和方法（注意，C1Report使用twips做为测量单位，一个twips表示1/20个point，因此一英寸等于72个point，或者等于1440个twips）C1Report Object:主要的组件

ReportName，GetReportInfo， Load，Save， Clear，Render，RenderToFile，RenderToStream，PageImages，Document，DoEvents，IsBusy，Cancel，Page，MaxPages，Font，OnOpen，OnClose，OnNoData，OnPage，OnError，Evaluate，Execute Layout Object:指示如何在页面上呈现报表

Width，MarginLeft，MarginTop，MarginRight，MarginBottom，PaperSize，Orientation，Columns，ColumnLayout，PageHeader，PageFooter，Picture，PictureAlign，PictureShow DataSource Object: 管理数据源

ConnectionString，RecordSource，Filter，MaxRecords，Recordset Groups Collection:报表可以具有多个分组 Group Object:控制数据排序和分组

Name，GroupBy，Sort，KeepTogether，SectionHeader，SectionFooter，Move Sections Collection:任何报表都具有五个以上的报表节

Section Object:报表节，包含Field对象（也称之为“report band”）

Name，Type，Visible，BackColor，OnFormat，OnPrint，Height，CanGrow，CanShrink，Repeat，KeepTogether，ForcePageBreak

Fields Collection:一个报表通常包含大量的Field Field Object:用来显示信息的方形区域

Name，Section，Text，TextDirection，Calculated，Value，Format，Align，WordWrap，Visible，Left，Top，Width，Height，CanGrow，CanShrink，Font，BackColor，ForeColor，BorderColor，BorderStyle，LineSlant，LineWidth，MarginLeft，MarginRight，MarginTop，MarginBottom，LineSpacing，ForcePageBreak，HideDuplicates，RunningSum，Picture，PictureAlign，Subreport，CheckBox，RTF

报表的节

报表节 内容（Detail） 报表页眉 报表页脚 页眉 页脚

描述

内容部分包含为数据记录集合中间的每一条记录重复渲染一次的Field的集合。 报表的页眉部分呈现在一个报表的开头位置。 报表的页脚部分呈现在一个报表的末尾。

页眉部分呈现在每一页的开始部分（除了包含报表页眉的页，此项为可选项） 页脚部分呈现在每一页的底部（除了包含报表页脚的页，此项为可选项）

除了以上这五个基本的报表节部分，每一个分组还具有额外的两个报表节：一个分组页眉和一个分组页脚部分。比如说，一个具有三个分组级别的报表将具有11个报表节。

注意：报表节可以设置为不可见，但是不可以添加或者删除报表节。添加删除分组功能除外。 下图展示在一个典型的报表中，每一个报表节部分是如何呈现的：

报表页眉

最开始呈现的是报表页眉部分。该报表节通常会包含报表的标识信息。 页眉

在报表页眉之后显示的是页眉。如果一个报表不具有任何分组，该部分通常包含内容（Detail）报表节中包含的字段的标签。 分组页眉和分组页脚

接下来的报表节部分包括分组页眉，内容，以及分组页脚。这些报表节部分将包含实际的报表数据。分组页眉和页脚通常包含汇总功能，比如说分组合计，百分比，最大最小值等等。分组页眉和分组页脚通常在由GroupBy属性执行的表达式的值由一个记录变为另一个记录时插入。 内容（Detail）

内容报表节部分包含每一条记录的数据。可以通过设置Visible属性的值为False隐藏该部分，而仅仅显示分组页眉和分组页脚。这是创建汇总报表的好办法。 页脚

每一页的底部显示的是页脚报表节部分。该部分通常包含诸如页码、报表总页数、以及/或报表打印日期等信息。

报表页脚

最后，报表页脚将在最后一页的页脚之前打印。此部分通常用作显示关于整个报表的总结信息。 自定义报表节

您可以通过设置Visible属性为True或者False以决定是否显示某一个报表节部分。可以通过设置Repeat属性的值为True使得分组页眉可以在每一页顶部重复打印（不管这里是否是一个分组的开始位置）。可以通过设置Layout对象上的PageHeader以及PageFooter属性使得在包含报表页眉和报表页脚部分的页面不显示页眉和页脚。