如何将报表查看器控件默认导出格式设为.xls而非.xlsx？

问题描述 #

我们的应用需要通过报表查看器控件生成.xls格式文件，但当前导出Excel时仅提供.xlsx和「其他文件」两个选项。选择「其他文件」并手动设置后缀为.xls后，文件实际格式仍是.xlsx，导致用户打开时弹出格式不匹配的警告对话框。同时，报表查看器的导出选项里原本显示3种可导出类型，但Excel相关的只有上述两个选项，希望能将Excel类文件的默认导出格式改为真正的.xls。

图1：报表查看器显示3种可导出的文件类型
图2：报表查看器选择文件时默认.xlsx格式，希望改为默认.xls格式

解决方案 #

针对常见的Microsoft Report Viewer控件（WebForms/WinForms），可以通过以下两种方式设置默认导出为.xls：

1. 通过配置文件修改渲染扩展优先级

在项目的Web.config（Web项目）或App.config（桌面项目）中添加/修改报表渲染扩展的配置，将.xls对应的Excel扩展设为默认：

<configuration>
  <!-- 保留原有配置内容 -->
  <configSections>
    <section name="reporting" type="Microsoft.Reporting.WebForms.ReportingConfigurationSection, Microsoft.ReportViewer.WebForms, Version=你的控件版本号, Culture=neutral, PublicKeyToken=89845dcd8080cc91" requirePermission="false" />
  </configSections>
  <reporting>
    <extensions>
      <render>
        <!-- 启用并设置.xls格式为默认导出选项 -->
        <extension name="Excel" type="Microsoft.Reporting.WebForms.ExcelRenderer, Microsoft.ReportViewer.WebForms" visible="true" default="true" />
        <!-- 可选：将.xlsx格式设为非默认 -->
        <extension name="EXCELOPENXML" type="Microsoft.Reporting.WebForms.ExcelOpenXmlRenderer, Microsoft.ReportViewer.WebForms" visible="true" default="false" />
      </render>
    </extensions>
  </reporting>
</configuration>

注意：请将配置中的Version=你的控件版本号替换为你实际使用的Report Viewer版本（比如15.0.0.0），版本号可从项目引用的Report Viewer程序集属性中查看。

2. 代码层面直接指定导出格式

如果需要跳过默认的导出选择对话框，直接生成真正的.xls文件，可以在导出按钮的事件中调用报表的渲染方法，指定使用Excel格式（对应.xls）：

// WinForms 示例代码
private void btnExportToXls_Click(object sender, EventArgs e)
{
    Warning[] warnings;
    string[] streamIds;
    string mimeType, encoding, extension;
    string deviceInfo = "<DeviceInfo><SimplePageHeaders>True</SimplePageHeaders></DeviceInfo>";

    // 渲染为原生.xls格式
    byte[] reportBytes = reportViewer1.LocalReport.Render(
        "Excel", 
        deviceInfo,
        out mimeType,
        out encoding,
        out extension,
        out streamIds,
        out warnings);

    // 弹出保存对话框让用户选择路径
    using (SaveFileDialog saveDialog = new SaveFileDialog())
    {
        saveDialog.Filter = "Excel 97-2003 文件 (*.xls)|*.xls";
        saveDialog.DefaultExt = "xls";
        if (saveDialog.ShowDialog() == DialogResult.OK)
        {
            using (FileStream fs = new FileStream(saveDialog.FileName, FileMode.Create))
            {
                fs.Write(reportBytes, 0, reportBytes.Length);
            }
            MessageBox.Show("报表导出成功！");
        }
    }
}

第三方控件说明 #

如果使用的是DevExpress、Telerik等第三方报表控件，核心思路一致：找到控件对应的.xls导出扩展，在配置或代码中设置其为默认导出选项，或者直接调用该格式的导出方法。具体操作可以参考对应控件的官方文档。

内容的提问来源于stack exchange，提问作者John Evans Solachuk