Web报表设计器 - 如何使用自定义序列化程序类?看完就懂了! DevExpress.net报表WEB
程序员文章站
2022-03-03 15:58:42
...
DevExpress Universal Subscription拥有.NET开发需要的所有平台控件,包含600多个UI控件、报表平台、DevExpress Dashboard eXpressApp 框架、适用于 Visual Studio的CodeRush等一系列辅助工具。
系统背景
- 平台:
- ASP.NET Core
- ASP.NET Web Forms
- WinForms
- WPF
- 产品:XtraReports Suite
从v18.2开始,使用XPO Data Source 将报表绑定到XPO数据。报表支持XPO数据源的内置序列化,因此您无需实现任何自定义序列化程序。
本文演示如何使用实现IDataSerializer接口的自定义数据源组件序列化器类来序列化报表的数据源组件。当您显示的报表使用的数据源组件无法被报表(DataSet,IList)序列化时,这种方法是可行的。 Web报表设计器仅存储报表定义,因此如果未序列化数据源组件,则无法在回调中恢复该组件,结果设计器的Field List和Preview将为空。
请注意,以下数据源组件是开箱即用的,因此在使用这些组件时不必使用此方法:
- SqlDataSource
- EFDataSource
- ObjectDataSource
- Excel Data Source
- JSON Data Source
- Data Federation
- XPO Data Source
使用以下步骤序列化报表的数据源组件:
- 创建一个实现IDataSerializer接口的自定义数据源组件序列化程序类,实现此接口的方法来从字符串保存(在Serialize方法中)和还原(在Deserialize方法中)您的数据源组件。
- 启动应用程序时,注册您的自定义数据源组件序列化程序类。 例如,为达到此目的,在应用程序的Global.asax.cs文件中使用Application_Start事件:
protected void Application_Start(object sender, EventArgs e) { SerializationService.RegisterSerializer(XPCollectionSerializer.NAME, new XPCollectionSerializer()); }
- 将自定义数据源组件序列化程序名称(您已在上一步中注册)分配给报表,如下所示:
XtraReport report = new CategoriesReport(); report.Extensions[SerializationService.Guid] = XPCollectionSerializer.NAME;
在Web报表设计器中打开报表之前,应执行此操作。
重要说明:此方法仅适用于XML序列化。 因此,如果要与序列化的数据源一起保存报表,请使用XtraReport.SaveLayoutToXml方法保存报表的定义。