ASP.NET Core如何集成RDLC报表、复用旧报表并传递数据

1. ASP.NET Core 中使用RDLC报表的配置方式 #

ASP.NET Core 没有内置RDLC报表运行时，直接安装适配.NET Core/.NET 5+的RDLC运行时NuGet包即可，不需要依赖System.Web和IIS专属组件，Windows、Linux部署环境都能正常运行。
配置步骤：

• 将原有RDLC文件拷贝到ASP.NET Core项目的指定目录（比如单独建Reports文件夹存放），将文件生成操作设置为「嵌入的资源」或「内容（较新则复制）」，对应你选择的文件加载方式即可。
• 在Program.cs中注册报表渲染所需的基础服务，不需要额外配置中间件。
• 报表渲染支持直接导出PDF、Excel、Word等常用格式，直接在控制器中生成对应格式的文件流返回即可；如果需要网页端在线预览，直接将生成的PDF流返回给前端，配合pdf.js即可实现预览效果，不需要迁移旧项目里的WebForms版ReportViewer控件。

2. 旧项目RDLC文件是否需要重新制作 #

90%以上的场景不需要重新创建，原有RDLC文件可以直接复用：

• 只要旧RDLC是基于2016及以上版本RDL架构制作的，不管之前是绑定DataSet、EF实体还是其他数据源，只要保留报表的布局、表达式、参数定义，直接拷贝到Core项目就能正常加载。
• 仅少数特殊场景需要调整：如果旧RDLC的表达式里调用了仅.NET Framework GAC存在的自定义程序集、或者强依赖System.Web的内置方法（比如旧版本的Url生成、请求上下文获取逻辑），这部分逻辑不要放在RDLC里实现，移到控制器中处理完成后，作为参数或数据集传给报表即可；如果有自定义报表程序集，把程序集升级到.NET Standard/.NET Core兼容版本即可，不用改RDLC本身的布局。
• 不用在意旧RDLC设计时绑定的数据源配置，运行时数据绑定完全由代码控制，设计时的数据源配置不会影响Core环境下的运行效果。

3. 控制器向RDLC传值的实现方式 #

传值分参数传递和数据集传递两类，全部在控制器代码中完成，不需要依赖设计器的数据源绑定配置，示例代码如下：

// 引入RDLC运行时的对应命名空间
public async Task<IActionResult> ExportSaleReport(DateTime startDate, DateTime endDate)
{
    // 拼接RDLC文件的实际存储路径
    var reportPath = Path.Combine(webHostEnv.ContentRootPath, "Reports", "SaleStatistic.rdlc");
    using var localReport = new LocalReport();
    localReport.ReportPath = reportPath;

    // 传递普通报表参数：参数名必须和RDLC中定义的参数名完全一致
    var reportParams = new List<ReportParameter>
    {
        new ReportParameter("StartDate", startDate.ToString("yyyy-MM-dd")),
        new ReportParameter("EndDate", endDate.ToString("yyyy-MM-dd")),
        new ReportParameter("ReportOperator", User.Identity?.Name ?? "系统")
    };
    localReport.SetParameters(reportParams);

    // 传递数据集：数据集名称必须和RDLC中定义的DataSet名称完全一致，大小写敏感
    var saleData = await saleService.GetStatisticData(startDate, endDate);
    var shopList = await shopService.GetAllShops();
    localReport.DataSources.Add(new ReportDataSource("ds_SaleData", saleData));
    localReport.DataSources.Add(new ReportDataSource("ds_ShopList", shopList));

    // 渲染为PDF格式返回，也可指定为Excel、Word等格式
    var renderResult = localReport.Render("PDF");
    return File(renderResult.MainStream, "application/pdf", $"销售统计_{startDate:yyyyMMdd}_{endDate:yyyyMMdd}.pdf");
}

传值注意事项：

• 不管是参数名还是数据集名称，必须和RDLC设计时定义的名称完全匹配，大小写错误会直接触发运行时错误，这是迁移过程中最常见的问题。
• 如果报表包含子报表，需要在渲染前给LocalReport注册SubreportProcessing事件，在事件回调中给子报表填充对应参数和数据集，逻辑和主报表传值完全一致。
• 建议不要在RDLC中配置直连数据库的连接信息，所有业务数据统一在控制器/业务层查询完成后传入，既规避了Core环境下旧数据库连接配置的兼容问题，也更符合权限管控要求。

内容的提问来源于stack exchange，提问作者Ahmed Jahin Akif