ReportDocument 类为 SDK 提供了范围比 CrystalReportViewer 对象模型更广泛的对象模型。
ReportDocument 类是 CrystalDecisions.CrystalReports.Engine 命名空间的组成部分。它起到一条通道的作用，通向 Engine 命名空间中的一组类，这些类为通过编程方式对报表进行操作提供了更多工具。
ReportDocument 对象模型
在上一节中，介绍了如何通过将报表路径字符串直接赋给 CrystalReportViewer 控件来使用基本的 CrystalReportViewer 对象模型。请参见 “CrystalReportViewer 对象模型”。
在对象模型的下一个级别，将在把报表赋给该控件之前，使用 ReportDocument 对象模型将报表封装到一个 ReportDocument 实例内。这样就可以访问 ReportDocument 中提供的更为复杂和强大的对象模型了。
.gif) 注意 |
|---|
由于此过程会涉及这两个对象模型（使用 CrystalReportViewer 加载和显示报表，使用 ReportDocument 封装和操作报表），因此这两个对象模型的角色容易被混淆。使用 ReportDocument 对象模型封装了报表后，所有报表操作必须限制在该模型中。如果尝试使用 CrystalReportViewer 的属性和方法来操作报表，这两个对象模型会发生冲突，导致意外的行为。 在引入了附加的对象模型后，应将 CrystalReportViewer 代码的使用限制为仅用于设置显示属性。 有关如何选择对象模型的更多信息，请参见“应该使用哪种对象模型？”。 |
ReportDocument 和 ReportClientDocument（RAS）
在Crystal Reports 9 中，这两种对象模型是完全分开的。在 Crystal Reports 10 和更高版本中，这两种对象模型已不再是彻底分开的。ReportDocument 对象模型现在是 ReportClientDocument 对象模型功能的代理（子集）。
Crystal Reports 2008 允许用户通过 ReportDocument.ReportClientDocument 属性访问 ReportClientDocument 对象模型的受限版本。
ReportDocument 对象模型关系图
此关系图显示了 ReportDocument 对象模型的关系。
.gif)
图 3: ReportDocument 对象模型
请参见
-
本节介绍了有关 ReportDocument 对象模型的多种教程。