如何为ReportViewer导出的Excel文件添加自定义元数据？

要通过ReportViewer自带的导出按钮控制Excel文件的元数据，你可以拦截导出按钮的点击事件，替换默认导出流程，手动生成并修改Excel元数据后再输出给客户端，用户体验和使用原生按钮完全一致。

实现步骤 #

1. 安装依赖库 #

根据导出的Excel格式选择对应NuGet包：

• 针对.xlsx格式：安装EPPlus 4.5.3.3（兼容.NET Framework 4.6.1，MIT许可证，无需商业授权）
• 针对.xls格式：安装NPOI（支持旧版Excel格式）

2. 绑定ReportViewer的ToolbarItemClicked事件 #

在ASPX页面的ReportViewer控件上添加事件绑定：

<rsweb:ReportViewer ID="ReportViewer1" runat="server" 
    OnToolbarItemClicked="ReportViewer1_ToolbarItemClicked"
    ProcessingMode="Local">
    <!-- 你的报表配置（比如LocalReport、数据源等） -->
</rsweb:ReportViewer>

3. 编写事件处理代码 #

在后台代码中拦截Excel导出动作，修改元数据后输出：

处理.xlsx格式（推荐）

using OfficeOpenXml;
using System.IO;
using System.Web;
using System;

protected void ReportViewer1_ToolbarItemClicked(object sender, Microsoft.Reporting.WebForms.ToolbarItemClickedEventArgs e)
{
    // 拦截Excel（xlsx）导出按钮
    if (e.ToolbarItem is Microsoft.Reporting.WebForms.ExportToolbarItem exportItem && 
        exportItem.Name == "EXCELOPENXML")
    {
        e.Cancel = true; // 取消默认导出行为

        // 生成原始Excel字节流
        byte[] excelBytes = ReportViewer1.LocalReport.Render(
            "EXCELOPENXML",
            null,
            out string mimeType,
            out string encoding,
            out string fileNameExtension,
            out string[] streams,
            out Warning[] warnings);

        // 使用EPPlus修改元数据
        using (MemoryStream ms = new MemoryStream(excelBytes))
        {
            using (ExcelPackage package = new ExcelPackage(ms))
            {
                // 设置自定义元数据
                package.Workbook.Properties.Title = "月度销售报表";
                package.Workbook.Properties.Author = "技术部";
                package.Workbook.Properties.Keywords = "销售,报表,Excel";
                package.Workbook.Properties.Subject = "2024年5月销售数据";
                package.Workbook.Properties.Comments = "系统自动导出，请勿修改";

                // 更新字节流
                excelBytes = package.GetAsByteArray();
            }
        }

        // 将修改后的Excel输出给客户端
        HttpResponse response = HttpContext.Current.Response;
        response.Clear();
        response.ContentType = mimeType;
        response.AddHeader("Content-Disposition", $"attachment; filename=SalesReport_{DateTime.Now:yyyyMMddHHmmss}.xlsx");
        response.BinaryWrite(excelBytes);
        response.End();
    }
}

兼容.xls格式（可选）

如果需要支持旧版.xls格式，替换元数据修改部分的代码：

using NPOI.HSSF.UserModel;
using System.IO;

// ... 前面的拦截逻辑不变 ...

// 针对xls格式修改元数据
using (MemoryStream ms = new MemoryStream(excelBytes))
{
    using (HSSFWorkbook workbook = new HSSFWorkbook(ms))
    {
        workbook.SummaryInformation.Title = "月度销售报表";
        workbook.SummaryInformation.Author = "技术部";
        workbook.SummaryInformation.Keywords = "销售,报表,Excel";
        workbook.SummaryInformation.Subject = "2024年5月销售数据";

        using (MemoryStream outputMs = new MemoryStream())
        {
            workbook.Write(outputMs);
            excelBytes = outputMs.ToArray();
        }
    }
}

4. 适配远程报表（ServerReport） #

如果ReportViewer使用ProcessingMode="Remote"，将LocalReport.Render替换为ServerReport.Render即可：

excelBytes = ReportViewer1.ServerReport.Render(
    "EXCELOPENXML",
    null,
    out string mimeType,
    out string encoding,
    out string fileNameExtension,
    out string[] streams,
    out Warning[] warnings);

注意事项 #

• 导出按钮名称匹配：EXCELOPENXML对应xlsx，Excel对应xls，不同版本ReportViewer可能略有差异，可通过调试查看exportItem.Name的值。
• 异常处理：建议添加try-catch块捕获导出或元数据修改过程中的异常，避免页面崩溃。
• 权限问题：使用ServerReport时，确保当前用户有访问报表服务器的权限。

内容的提问来源于stack exchange，提问作者Ahmet Şenlik