本主题说明了把报表文档导出为 CSV (逗号分隔取值) 格式的细节。
把文档导出为 CSV 文件时可以指定的选项,被存储在 CsvExportOptions 类中,并且可以通过报表的 ExportOptions.Csv 属性来访问。
在这些选项中,TextExportOptionsBase.TextExportMode 属性确定对于导出的 CSV 文档中的单元格,是否使用绑定数据集中数据字段的格式。 注意,如果此属性值被设置为 Text,那么所有数据字段都被以 字符串 (在字符串中嵌入相应的格式) 导出到 CSV 文件。
注意 |
---|
注意,只有那些 没有相互交叉 的报表控件可以被正确导出为 CSV。 在其他情况下,形成的 CSV 文件可能会有完全混乱的布局。 |
为了确保报表布局可以被保存为 CSV 格式,请在设计时刻启用报表的 DesignerOptions.ShowExportWarnings 属性,并检查以确保没有为相交控件 (以 红色 着色) 显示惊叹记号 (四向大小调整光标)。
当导出为 CSV 文件时,XtraReports 使用 XRControl 类的受保护的 GetTextView 方法,此方法在适当的 报表控件 中被重写。 此方法返回一个二维字符串数组,用于控件的文本表示形式。 例如,XRLabel 被表示为一个简单的字符串,XRRichTextBox 被表示为一个一维字符串数组,XRTable 被表示为一个二维字符串数组,XRPictureBox 则不能被表示为字符串。
可以使用下列方法之一把报表导出为 Csv。
- XtraReport.ExportToCsv (传递或不传递 CSV 导出选项作为参数);
- ReportViewer.WriteTextTo。