当采用 Crystal Reports Engine 对象模型开发报表时，最常用的类就是 ReportDocument 类，该类被用来代表报表本身并且内含所有用来定义、载入、导出、格式化与打印报表的属性、方法与事件。 <?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

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 对象加载的报表是否是活动的