水晶报表基础入门――2.水晶报表命名空间下包含的类2

当采用 Crystal Reports Engine 对象模型开发报表时，最常用的类就是 ReportDocument 类，该类被用来代表报表本身并且内含所有用来定义、载入、导出、格式化与打印报表的属性、方法与事件。

ReportDocument 类常用公共属性及说明如表 6.2 所示。

表 6.2                   ReportDocument 类常用公共属性及说明

属性	说明
Database	获取 Database 对象
DataDefinition	获取 DataDefinition 对象
DataSourceConnections	包含报表中所有表连接信息的 IConnectionInfo 对象的集合。不包括子报表
EnterpriseSession	当 RAS 服务器由 BusinessObjects Enterprise 管理时，获取或设置对 EnterpriseSession 对象的引用
ExportOptions	获取 ExportOptions 类实例
FileName	指定报表文件的名称。如果指定协议或盘符，则假定使用默认的 "ras://"
FilePath	指定不带协议前缀的报表文件的名称
HasSavedData	获取报表是否有保存在内存中的数据
IsLoaded	获取该报表是否已使用 Load 方法加载
sSubreport	获取该报表是否是子报表
Name	获取报表的名称。对于主报表，该报表名称为空
ParameterFields	获取参数字段
PrintOptions	获取 PrintOptions 对象
RecordSelectionFormula	获取或设置记录选定公式
ReportAppServer	获取或设置报表应用程序服务器（也称为 RAS 服务器）的名称
ReportClientDocument	ReportClientDocument 类是进入基础 Report Application Server API 的入口点。如果 ReportDocument.ReportAppServer 未指向 Report Application Server ，则此属性将抛出异常
ReportDefinition	获取 ReportDefinition 对象
ReportOptions	获取 ReportOptions 对象
Subreports	子报表。获取 Subreports 对象
SummaryInfo	获取 SummaryInfo 对象

ReportDocument 类常用公共方法及说明如表 6.3 所示。

表 6.3                    ReportDocument 类常用公共方法及说明

方法	说明
Close	关闭报表
EnableEventLog	启用打印引擎的事件日志。默认情况下该日志未启用
Export	将报表导出到在 ExportOptions 对象内指定的格式和目标
ExportToDisk	将报表以指定格式导出到文件中
ExportToHttpResponse	将报表以指定格式导出到响应对象中
ExportToStream	将报表以指定格式导出到流中
GetConcurrentUsage	返回打开的并行作业个数，允许开发人员在应用程序中生成许可监视
Load	加载一个新报表。如果已加载了一个报表，则关闭它并打开一个新报表
OpenSubreport	打开报表中包含的子报表并返回与命名子报表对应的 ReportDocument 对象
PrintToPrinter	使用 PrintOptions.PrinterName 属性将报表的指定页输出到选定的打印机上。如果未选择打印机，则将使用报表中指定的默认打印机
Refresh	删除保存的数据。这将导致随后查看报表时载入新数据
SaveAs	将报表保存到指定的文件中
SetCssClass	为各种节和报表对象设置级联式样式表 (CSS)
SetDatabaseLogon	利用用户名和密码设置数据库登录信息
SetDataSource	将 Object 传递给报表引擎
VerifyDatabase	检查数据库连接对于 ReportDocument 对象加载的报表是否是活动的