本文档阐述了如何在 XtraReports 中设置数据格式。 我们把“格式”定义为控件的输入数据的表现形式。 主要需要设置日期时间、货币、百分数和数值数据的格式。
使用 XtraReports,可以把下面的一种或两种格式应用于数据。
基本的格式
可以 只 把格式应用于 绑定 到控件的属性的取值,并且 不 应用于控件的 静态 内容。
例如,通常要设置 XRLabel 的 XRControl.Text 属性。 通过 XRBinding.FormatString 属性来完成此任务。 在设计时刻,单击此属性的省略号按钮,从而调用 FormatString Editor 对话框,此对话框中包含了按类别分组的大量预定义的内置格式。
在此对话框中,选择所需的预置格式,或者指定自定义格式,然后单击 OK 按钮。 相关的按步骤操作指南,请参阅 如何: 设置数据格式。
以类似的方式,对于 XRLabel 控件,也可以把格式应用于 XRControl.NavigateUrl (例如,把 https:// 前缀添加到链接的内容)、XRControl.Tag 和 XRControl.Bookmark 属性。 并且,不同的控件类型有不同的可绑定属性集。
汇总的格式
注意,XRSummary 对象有自己的 XRSummary.FormatString 属性,如下面的插图所展示的那样。 要获得相关细节,请参阅 计算汇总。
邮件合并的格式
当创建 邮件合并报表 时,通过 ! 符号分隔数据字段名称,可以为嵌入的数据字段指定格式字符串。
相关的按步骤操作指南,请参阅 如何: 创建邮件合并报表。
除了 .NET 格式字符串之外,还可以把 XLSX 自有格式应用于 XRLabel 的 (或 XRTableCell 的) 内容 (使用它的 XRControl.XlsxFormatString 属性来设置格式)。 如果 XlsExportOptionsBase.TextExportMode 属性值被设置为 Value,那么指派到 XRControl.XlsxFormatString 属性的取值被视为 Excel® 的格式字符串进行处理。
如果 XRControl.XlsxFormatString 属性没有被设置任何值,那么将把 .NET 格式字符串 (如果指定) 应用于控件的内容来代替。
如果 XlsExportOptionsBase.TextExportMode 属性值被设置为 Text,那么所有控件内容都被导出为普通文本,而不导出所应用的格式。
XLSX 格式优先于 .NET 格式。 因此,如果同时为控件指定这两种格式,那么当报表文档被导出为 XLSX 文件(或流) 时,会使用 XLSX 格式。
更多信息,请参阅 导出为 XLSX。