CrystalReportViewer 类具有两个角色:
- 在 Web 或 Windows 窗体中,CrystalReportViewer 作为一个 .NET 控件提供,可将该控件添加到窗体上以显示报表。有关其作为 .NET 控件的角色的特定信息,请参见“报表查看器控件”。
- 在 Web 或 Windows 窗体的基础代码中,CrystalReportViewer 类提供了最简单的 SDK 对象模型。我们将在本节中稍后探讨该对象模型。
要将报表放到 Web 或 Windows 窗体中,最简单的方法是将 CrystalReportViewer 控件添加到窗体中,然后在此代码隐藏类中将报表的路径作为一个字符串赋给 CrystalReportViewer 类的 ReportSource 属性。
通过将报表路径直接赋给该控件(而不是将报表放在较复杂的对象模型中,例如,ReportDocument 或 ReportClientDocument),可将接口限制为只使用最简单的对象模型:CrystalReportViewer。
注意 |
|---|
有关如何选择对象模型的更多信息,请参见“应该使用哪种对象模型?”。 |
CrystalReportViewer 对象模型关系图
这些关系图显示了 CrystalReportViewer 对象模型中各实体的关系。
CrystalReportViewer 具有两个对象模型关系图,这是因为对 Windows 和 Web 应用程序重复使用了相同的控件和类名称(因此也重复使用其基础对象模型)。因此,CrystalReportViewer 对象模型在两个不同的命名空间中重复(有一些较小的差别)。
CrystalReportViewer 对象模型的 Windows 版本包含其 Windows 版本和 Web 版本都具有的主要的类和事件。
.gif)
图 1: CrystalDecisions.Windows.Forms.CrystalReportViewer 对象模型
CrystalReportViewer 对象模型的 Web 版本与 Windows 版本包含相同的类和事件,但除此之外,它还具有以下与 ASPX 页的加载方式相关的事件。
.gif)
图 2: CrystalDecisions.Web.CrystalReportViewer 对象模型
请参见
-
本节中的教程使用 CrystalReportViewer 类中的方法和属性,以及 CrystalDecisions.Shared 命名空间的类。
注意