水晶报表基础入门――7.晶报表导出数据技术1

6.1.6  水晶报表导出数据技术

对象模型最常见的应用方法之一是运行报表并导出到另一种文件格式。 ReportDocument 对象是 CrystalDecisions.CrystalReports.Engine 命名空间下的成员类，它表示一个报表，并且包含定义、格式化、加载、导出和打印该报表的属性和方法。 ReportDocument 对象提供以下几种导出报表数据的方法。

l          ExportToDisk 方法

将报表以指定格式导出到文件中。这是导出报表最简单的方法；通过接受变量来指定导出格式类型和导出的文件名。在只需要导出一个文件到磁盘上的时候，这种方法很有用。

语法：

public virtual void ExportToDisk(CrystalDecisions.Shared.ExportFormatTypeformatType ,string fileName )

参数说明：

formatType ：用来导出报表的格式类型。 FormatType 值是一个 ExportFormatTypeformatType 枚举类型值， ExportFormatTypeformatType 枚举类型值及说明如表 6.4 所示。

FileName ：用来导出报表的文件名。

表 6.4                ExportFormatTypeformatType 枚举值及说明

成员	说明
CrystalReport	报表的导出格式是 Crystal Report 文件
Excel	报表的导出格式是 Microsoft Excel 文件
ExcelRecord	报表的导出格式是 Excel 记录文件
HTML32	报表的导出格式是 HTML 3.2 文件
HTML40	报表的导出格式是 HTML 4.0 文件
NoFormat	未指定导出格式
PortableDocFormat	报表的导出格式是 PDF 文件
RichText	报表的导出格式是 Rich Text 文件
WordForWindows	报表的导出格式是 Microsoft Word 文件

l          ExportToStream 方法

此方法只能接受一个单独的变量，导出格式类型。方法返回值是 System.IO.Stream 对象。

语法：

public virtual System.IO.Stream ExportToStream(CrystalDecisions.Shared.ExportFormatType formatType)

参数说明：

formatType ：用来导出报表的格式类型。 FormatType 值是一个 ExportFormatTypeformatType 枚举类型值， ExportFormatTypeformatType 枚举类型值及说明如表 6.4 所示。

返回值：包含字节序列形式的导出报表的流。

l          ExportToHttpResponse 方法

此方法将报表以指定格式导出到响应对象中。其有两种重载形式。

语法：

public virtual void ExportToHttpResponse(CrystalDecisions.Shared.ExportFormatType formatType,System.Web.HttpResponseresponse,bool asAttachment,string attachmentName);

参数说明：

formatType ：用来导出报表的格式类型。 FormatType 值是一个 ExportFormatTypeformatType 枚举类型值， ExportFormatTypeformatType 枚举类型值及说明如表 6.4 所示。

Response ：页面的响应对象。

AsAttachment ：指示是否将报表导出为响应的附件。

AttachmentName ：用来导出报表的文件名。

Public virtual void ExportToHttpResponse(CrystalDecisions.Shared.ExportOptions options,
System.Web.HttpResponse response ,bool asAttachment ,string attachmentName);

参数说明：

options ：报表的导出选项。

response ：页面的响应对象。

asAttachment ：指示是否将报表导出为响应的附件。

attachmentName ：用来导出报表的文件名。

ExportToHttpResponse() 方法不支持导出为 HTML32 和 HTML40 格式的 HTTP 响应。因此，当尝试导出为 HTML32 或 HTML40 时，会出现错误消息。

如果 asAttachment 布尔值变量设置为 True ，则会出现 “ 文件下载 ” 对话框。如果 asAttachment 布尔值变量设置为 False ，导出的报表会在浏览器窗口中打开。

当选择保存文件时，文件名设置为 attachmentName 字符串变量。如果不指定 attachmentName 变量，则默认文件名为 “ 无标题 ” ，并带有指定的文件扩展名。可在 “ 另存为 ” 对话框中更改文件名。

l          Export 方法

将报表导出到在 ExportOptions 对象内指定的格式和目标。

语法：

public virtual void Export(CrystalDecisions.Shared.ExportOptions options);

参数说明：

options ：导出报表的格式和目标。

此方法可以接受名为 ExportOptions 的对象作为变量，描述导出格式类型和目的类型。

ExportOptions 对象是 CrystalDecisions.Shared 命名空间下的一个类，它提供属性，以便检索和设置用于导出报表的选项。

ExportOptions 对象常用的属性及说明如表 6.5 所示。

表 6.5                    ExportOptions 对象常用的属性及说明

属性	说明
DestinationOptions	获取或设置 DestinationOptions
ExportDestinationOptions	获取或设置报表的导出目标选项
ExportDestinationType	获取或设置导出目标类型
ExportFormatOptions	获取或设置 FormatOptions
ExportFormatType	获取或设置导出格式类型
FormatOptions	获取或设置 FormatOptions

下面对比较重要的属性进行详细介绍。

（ 1 ） DestinationOptions 属性

获取或设置 DestinationOptions 。

语法：

public object DestinationOptions{get; set;}

DestinationOptions 对象包括 DiskFileDestinationOptions 、 ExchangeFolderDestinationOptions 或 MicrosoftMailDestinationOptions 对象。

l          DiskFileDestinationOptions 对象

检索和设置导出到磁盘时的文件名。如果将报表导出至一个磁盘文件，使用 DiskFileDestinationOptions 对象的 DiskFileName 属性来设置目的文件的完整路径与文件名称。

l          ExchangeFolderDestinationOptions 对象

检索和设置导出到 Microsoft Exchange 文件夹时的选项。如果将报表导出至 Microsoft Exchange 文件夹，应使用 ExchangeFolderDestinationOptions 对象的下列属性进行相关设置，如表 6.6 所示。

表 6.6            ExchangeFolderDestinationOptions 对象常用的属性及说明

属性	说明
DestinationType	获取或设置导出目标类型
FolderPath	获取或设置 Exchange 文件夹的路径，该文件夹用于导出到 Exchange 的报表
Password	获取或设置 Exchange 密码
Profile	获取或设置访问 Exchange 文件夹的用户配置文件，该文件夹用于导出到 Exchange 的报表

l          MicrosoftMailDestinationOptions 对象

提供属性，以便检索和设置导出到 Microsoft mail 时的选项。如果将报表导出至 Microsoft mail ，应使用 MicrosoftMailDestinationOptionss 对象的下列属性进行相关设置如表 6.7 所示。

表 6.7           MicrosoftMailDestinationOptions 对象常用属性及说明

属性	说明
MailCCList	获取或设置通过电子邮件发送的报表的副本（抄送）列表
MailMessage	获取或设置包含在通过电子邮件发送的报表中的电子邮件
MailSubject	获取或设置要通过电子邮件发送的报表的电子邮件主题
MailToList	获取或设置要通过电子邮件发送的报表的收件人列表
Password	获取或设置登录电子邮件账户时所需的密码
UserName	获取或设置登录电子邮件账户时所需的用户名