2024年4月3日发(作者：)

维普资讯

２００７年６月　电　脑　学　习　第３期　

ＶＳ．ＮＥＴ中Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的使用　

陈

摘

平　池同柱　

要：介绍了Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ功能、结构和特点．通过在ＶＳ．ＮＥＴ创建具体的Ｗｉｎｄｏｗｓ应用演示了Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的强大　

功能。　

关键词：　ＶＳ．ＮＥＴ　

中图分类号ＴＰ３１２　

ＣｒｙｓｔａｌＲｅｐｏｒｔｓ　

文献标识码Ａ　文章编号：１００２—２４２２（２００７）０３一ｏｏ１９～０２　

Ｔｈｅ　Ａｐｐｌｉｃａｔｉｏｎ　ｏｆ　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ　ｉｎ　ＶＳ．ＮＥＴ　

Ｃｈｅｎ　ＰｉＩｌｇ　Ｃｈｉ　Ｔｏｎｇｚｈｕ　

Ａｂｓｔｉ＇ａｃｔ：Ｔｈｅ　ｐａｐｅｒ　ｉｎｔｒｏｄｕｃｅｓ　ｔｈｅ　ｆｕｎｃｔｉｏｎ、ｓｔｒｕｃｔｕｒｅ　ａｎｄ　ｃｈａｒａｃｔｅｒｉｓｔｉｃ　ｏｆ　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ，ａｎｄ　ｓｈｏｗｓ　ｔｈｅ　ｐｏｗｅｒｆｕｌ　ｆｕｎｃｔｉｏｎ　

ｏｆ　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ　ｂｙ　ｃｒｅａｔｉｎｇ　ａ　ｄｅｔａｉｌｅｄ　Ｗｉｎｄｏｗｓ　ａｐｐｌｉｃａｔｉｏｎ　ｉｎ　ＶＳ．ＮＥＴ．　

Ｋｅｙｗｏｒｄ：ＶＳ．ＮＥＴ　ＣｒｙｓｔａｌＲｅｐｏｒｔｓ　

１　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ简介　

１．１　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的功能　

然后将ＤａｔａＳｅｔ作为数据源绑定到报表文件。　

对应两种不同的取数据的方法，Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ有两种　

（１）支持多种数据源和强大的内容创建功能；（２）交　

互式和自定义功能；（３）将报表并入应用程序。　

１．２　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的结构　

Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ访问数据库文件需要经过三层（如图　

执行模式（见图２、图３）：　

Ｃｒｙｓｔｌ　Ｒｅｐｏｒａｔｓ　数据库　

厂］　日　

Ｌ厂＿，　

图２　Ｐｕｌｌ模式　

Ｃｒｙｓｔｌ　Ｒｅｐｏｒａｔｓ　

１）：Ｃｒｙｓ￣ｌ　Ｒｅｐｏｒｔｓ作为接口运行，通过此接口可以对数据　

库文件中存储的数据进行格式化、排列、选择和排序。它通　

过与数据转换层中的一个或多个文件通讯来获取数据，此　

数据转换层通过一组专用于Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的ＤＬＬ对来　

自不同数据源的数据进行转换。　

［＝］　

图３　Ｐｕｓｈ模式　

（１）Ｐｕｕ模式：被请求时，Ｃｒｙｓｔｌａ　Ｒｅｐｏｒｔｓ直接根据指　

Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ层Ｈ　Ｃｒｙｓｔｌａ　Ｒｅｐｏｒｔｓ层　

图１　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ访问数据库　

定的驱动连接数据库，然后组装这些数据。　

（２）Ｐｕｓｈ模式：开发人员需要自己编写代码连接数据　

库并组装Ｄａｔａ，Ｓｅｔ，同时将ＤａｔａＳｅｔ中的数据传送至Ｃｒｙｓｔａｌ－　

Ｒｅｐｏｒｔｓ。　

Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ　Ｄｅｓｉｇｎｅｒ用于报表的设计，用户可以在　

报表设计过程中设置报表的标题、插入数据、公式、图表、子　

报表等操作。　

Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ　Ｖｉｅｗｅｒ是用于查看报表的控件。对于　

Ｗｅｂ应用和Ｗｉｎｄｏｗｓ应用分别有不同的Ｖｉｅｗｅｒ控件，但其　

功能基本相同，主要用途都是查看应用程序中的报表。除此　

之外，查看器控件对报表的控制是非常有限的。　

报表文件是在Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ　Ｄｅｓｉｎｅｒ中设计的，用来　ｇ

１．４　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的报表类型　

（１）Ｓｔｒｏｎｇｌｙ－Ｔｙｐｅｄ报表：如果报表被加入到项目中　

去，则该报表即为Ｓｔｒｏｎｇｌｙ—Ｔｙｐｅｄ报表。此时用户拥有创建　

报表对象的权力，能够减少代码并提高性能。　

（２）Ｕｎ—Ｔｙｐｃａ报表：如果报表不直接包含在项目中，　

称为Ｕｎ＿Ｔｙｐｏｄ报表。此时，用户需要用Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的　

ＲｅｐｏｒｔＤｏｃｕｍｅｎｔ对象创建一个实例，并手动调用报表。　

２　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ在ＶＳ．ＮＥＴ中的应用　

２．１建立到数据源的连接　

Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ支持多种类型数据的访问，如访问　

ＯＤＢＣ数据源、ＯＬＥＤＢ数据源、Ｅｘｃｅｌ、Ａｃｃｅｓｓ中的数据、　

ＸＭＬ、ＯＬＡＰ数据源。用户可以根据报表中数据的具体来源　

收稿日期：２００７－０１—１１　

・１９・　

确定来自数据源的数据显示方式的文件，默认安装方式下　

ＶＳ．ＮＥＴ已经安装一些报表文件（．ｒｐｔ）示例。　

１．３　Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的执行模式　

ＤａｔａＳｏｕｒｃｅ是报表文件中数据的来源。报表文件取得数　

据的方法有两种：一种是让Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ自己选择数据　

而不使用任何代码；另一种是手动编写代码组装ＤａｔａＳｅｔ，　

｝陈平河南工业职业技术学院计算机工程系讲师（南阳４７３００９），研究方向：数据库技术、软件工程　

维普资讯

建立到相应数据源的连接。若在Ｗｉｎｄｏｗｓ应用中报表的数　

据来源于ＳＱＬ　Ｓｅｒｖｅｒ２０００，可在ＶＳ．ＮＥＴ中从“工具箱”的　

“数据”选项卡上将“ＳｑｌＣｏｎｎｅｅｔｉｏｎ控件”拖到报表窗体　

中，在窗体下方显示该控件自动命名为ｓｑｌＣｏｎｎｅｅｔｉｏｎｌ。　

在ｓｑｌＣｏｎｎｅｅｔｉｏｎｌ控件的属性窗口中配置Ｃｏｎｎｅｃｔｉｏｎ—　

和ＣｒｙｓｔａｌＲｅｐｏｒｔ３，分别用来显示课程信息和学生成绩信息。　

２．５添加“ＣｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ”控件　

ＣｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ是用于查看报表文件的控件，从　

“工具箱”的“Ｗｉｎｄｏｗｓ窗体”中选取ＣｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ　

控件到窗体中去，默认名字为ＣｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒｌ，为了能　

够在一个报表查看控件中查看三种不同的报表，可以窗体　

上再添加一个ＣｏｍｂｏＢｏｘ控件ｃｏｍｂｏＢｏｘｌ，在其属性Ｉｔｅｍｓ　

中设置三个选项：学生信息表、课程信息表、成绩信息表，以　

Ｓｔｒｉｎｇ属性，选择“新建连接”，指定数据库服务器名称为　

“ＴＢＤＹＪ”，选取合适的身份认证方式并输入身份认证信　

息，如果正确即可继续选取该数据库服务器上的数据库　

“

ｓｔｕｄｅｎｔｓ”，认证信息不正确则无法继续进行。　

２．２建立数据适配器　

从ＶＳ．ＮＥＴ的“工具箱”的“数据”选项卡中拖动“ＳｑＬ　

ＤａｔａＡｄａｐｔｅｒ控件”到将要创建报表的窗体中去，建立名为　

ｓａＩＤａｔａＡｄａｐｔｅｒｌ的数据适配器同时自动弹出数据适配器向　

导对数据适配器进行配置。选了刚刚建立的到数据库连接，　

选择“使用ＳＱＬ语句”访问数据库，通过“查询生成器”将　

对视图Ｖ＿ｓｔｕｄ的查询作为数据适配器访问数据库ｓｔｕｄｅｎｔｓ　

的方式。　

按照同样的方式再创建两个数据适配器ｓｑｌＤａｔａＡｄａｐｔ—　

ｅｒ２和ｓｑｌＤａｔａＡｄａｐｔｅｒ３，分别配置为通过对视图Ｖ　ｃｏｕｒｓｅ、　

Ｖ

＿

ｓｃ查询来访问数据库ｓｔｕｄｅｎｔｓ。　

２．３　生成ＡＤＯ．ＮＥＴ数据集对象　

选取ｓｑｌＤａｔａＡｄａｐｔｅｒｌ并右键单击选中快捷菜单中的　

“生成数据集”，此时会弹出“生成数据集”的对话窗口，在　

其中选择“新建”并输入新创建的数据集对象的名称，默认　

为ＤａｔａＳｅｔ１，此时系统自动在当前项目中添加一个名为　

ＤａｔａＳｅｔ１的数据集对象，同时生成数据集对象ＤａｔａＳｅｔｌ的　

一

个实例，默认名称为ＤａｔａＳｅｔ１　１，并为数据集建立架构，其　

中包含了数据库ｓｔｕｄｅｎｔｓ中视图Ｖ＿ｓｔｕｄ及其字段和类型的　

描述，但并不包括实际数据。　

２．４设计新报表　

若准备在当前的工程中创建三种不同的报表分别显示　

学生情况、课程情况和每门课程学生选修情况及成绩，必须　

根据三种报表所要反映的内容创建三种不同类型的报表。　

先创建反映学生情况的报表。在“解决方案资源管理　

器”中选取当前的工程名称，右键单击在快捷菜单中选取　

“添加新项”，并在弹出的窗口的“模板”中选取“Ｃｒｙｓｔａｌ　

Ｒｅｐｏｒｔ”，再输入名称即可，默认为ＣｒｙｓｔａｌＲｅｐｏｒｔ１，此时即建　

立了一个新的报表类同时自动打开报表创建向导，用户可　

充分利用这些向导快速创建各种类型的功能强大的报表，　

在向导的帮助下可以快速选取报表中使用的数据来源（来　

源于刚刚生成的数据集ＤａｔａＳｅｔｌ１中的表Ｖ＿ｓｔｕｄ）、选取在　

报表中要显示的字段、数据分组的依据字段、是否进行总　

计、对报表中的数据进行筛选、报表类型、图表类型等。设置　

完成后，可在报表设计器中对刚刚设置过的报表样式外观　

进行修改和调整。　

依同样的方法可建立另外两个报表文件ＣｒｙｓｔａｌＲｅｐｏｒｔ２　

・　２０　・　

方便用户通过不同选择查看不同的报表。　

２．６添加事件处理代码　

采用数据访问的ｐｕｓｈ模式，将数据从数据源中需要的　

数据推入数据集中，并将在报表所在的窗体加载事件　

（Ｆｏｒｍ＿Ｌｏａｄ事件）中添加如下代码：　

ｓｑｌＤａｔａＡｄａｐｔｅｒ１．Ｆｉｌｌ（ｄａｔａＳｅｔ１１．”Ｖ＿ｓｔｕｄ　）：　

ＣｒｙｓｔａｌＲｅｐｏｒｔ　１　ｍｙｒｐｔ＝ｎｅｗ　ＣｒｙｓｔａｌＲｅｐｏｒｔ　１（）：　

ｍｙｒｐｔ．ＳｅｔＤａｔａＳｏｕｒｃｅ（ｄａｔａＳｅｔ１　１）：　

ｃｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ１．ＲｅｐｏｒｔＳｏｕｒｃｅ＝ｍｙｒｐｔ；　

可以通过ＣｏｍｂｏＢｏｘ控件来选择所要查看的报表文件，　

还必须在ｃｏｍｂｏＢｏｘｌ控件的ＳｅｌｅｅｔｅｄＩｎｄｅｘＣｈａｎｇｅｄ事件中　

添加如下代码：　

ｓｗｉｔｃｈ（１ｎｔ３２．Ｐａｒｓｅ（ｃｏｍｂｏＢｏｘ１．ＳｅｌｅｃｔｅｄＩｎｄｅｘ．ＴｏＳｔｒｉｎｇ（）））ｆ　

ｃａｓｅ　０：ｆ　

ｓｑｌＤａｔａＡｄａｐｔｅｒ１．Ｆｉｌ（ｄａｔａＳｅｔ１１，＂Ｖ

＿

ｓｔｕｄ　）；　

ＣｒｙｓｔａｌＲｅｐｏｒｔ１　ｍｙｒｐｔ＝ｎｅｗ　ＣＩｙｓｔａｌＲｅｐ０ｎ１（）；　

ｍｙｒｐｔ．ＳｅｔＤａｔａＳｏｕｒｅｅ（ｄａｔａ．Ｓｅｔ１　１）：　

ｃｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ１．ＲｅｐｏｒｔＳｏｕｒｃｅ＝ｍｙｒｐｔ；　

ｂｒｅａｋ；｝　

ｃａｓｅ　１：｛　

ｓｑｌＤａｔａＡｄａｐｔｅｒ２．Ｆｉｌｌ（ｄａｔａ．Ｓｅｔ　１　１，＂ｖ　ｃｏｕｒ＂）；　

ＣｒｙｓｔａｌＲｅｐｏｒｔ２　ｍｙｒｐｔ＝ｎｅｗ　ＣｒｙｓｔａｌＲｅｐｏｒｔ２（）；　

ｍｙｒｐｔ．ＳｅｔＤａｔａ．Ｓｏｕｒｃｅ（ｄａｔａＳｅｔ１　１）；　

ｃｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ１．ＲｅｐｏｒｔＳｏｕｒｃｅ＝ｍｙｒｐｔ；　

ｂｒｅａｋ；｝　

ｃａｓｅ　２：ｆ　

ｓｑｌＤａｔａＡｄａｐｔｅｒ３．ｉＦｌ（ｄａｔａＳｅｔ１　ｌ，”ｖ

—

ｓｃ”）；　

ＣｒｙｓｔａｌＲｅｐｏｒｔ４　ｍｙｒｐｔ＝ｎｅｗ　ＣｒｙｓｔａｌＲｅｐｏｒｔ４（）；　

ｍｙｒｐｔ．ＳｅｔＤａｔａＳｏｕｒｃｅ（ｄａｔａＳｅｔ１　１）；　

ｃｒｙｓｔａｌＲｅｐｏｒｔＶｉｅｗｅｒ１．ＲｅｐｏｒｔＳｏｕｒｃｅ＝ｍｙｒｐｔ；　

ｂｒｅａｋ；Ｉ　

３结束语　

本文通过使用Ｃｒｙｓｔａｌ　Ｒｅｐｏｒｔｓ的Ｐｕｓｈ数据访问模式在　

Ｗｉｎｄｏｗｓ应用程序中建立复杂的图表应用，展示了Ｃｒｙｓｔａｌ　

Ｒｅｐｏｒｔｓ的功能；对于报表的更复杂的控制，可以使用通过　

非类型化的报表组件，在程序中进行控制。　

参考文献　

【１】Ｓｈａｗｎ　Ｗｉｌｄｅｒｍｕｔｈ著，周靖译．ＡＤＯ．ＮＥＴ实用指南【Ｍ】．　

北京：清华大学出版社，２００３，（９）：１５１—１５２．　

【２】Ｃｈｒｉｓｔｉａｎ　Ｎａｇｅｌ，等著，李敏波译．Ｃ＃高级编程【Ｍ】．北　

京：清华大学出版社，２００６（１０）：５５２—５５８．