ComponentOne Reports for WinForms帮助文档

葡萄城针对WinForms平台最新推出的控件版本中,包含了一个名为C1.C1Report.C1Report的新组件。该组件对之前版本中的C1.Win.C1Report.组件实现了完全的兼容替代。从用户代码的角度来看,本次组件更新的唯一区别在于命名空间的改变(新版本使用C1.C1Report代替原版本中的C1.Win.C1Report)C1.C1Report命名空间仍然提供包括Field、Section等所有众所周知的C1Report公共类。因此,用户受到的唯一影响就是命名空间名称的改变。

然而,新版本的C1Report组件在内部工作机理上完全不同于原有版本。相对于原有C1Report引擎在通常情况(预览/打印)时需要根据页面图片生成图元文件的实现方式,新版本的C1Report只需要创建一个C1PrintDocument对象来表示该报表。如代码所述,用户可以使用C1Report下的公共只读属性C1Document的Get方法获取到C1PrintDocument对象。

C1PrintDocument C1Report.C1Document {get;}.

该对象可以用于任何常用方法;例如,它可以导出成任何一种C1PrintDocument支持的对象格式。

导出过滤器:

与过去版本中发布的其他公共组件一样,新的C1Report组件仍然使用WinFormsC1Report下的导出过滤器,因此过去编写的代码仍然有效:

report.Load(...);
report.RenderToFile("MyReport.rtf",C1.C1Report.FileFormatEnum.RTF);

在代码中,我们使用RenderToFile方法导出了一个RTF文件。然而值得注意的是, RenderToFile方法与代码3中使用C1Document下的Export方法导出的文件具有明显不同。

report.Load(...);
report.C1Document.Export("MyReport.rtf");

通常情况下,使用RenderToFile方法导出文件的方式比使用C1Document的Export方法更为妥善,除非导出的目标格式是固定排版格式(例如PDF格式)。两种方法在导出固定排版格式文件上不分优劣。

最后仍需注意的是,RenderToFile方法不支持新的XPS格式,生成XPS文件的唯一途径是通过调用C1PrintDocument的Export方法。

查看其它

 

 


产品网站:http://www.gcpowertools.com.cn  |  咨询热线:4006576008   |   ©2015 西安葡萄城