C#通过HTML字符串流导出Word文档的方法

核心原理与准备

该方法的基本逻辑是将服务器端的UI控件（如 Repeater、GridView）渲染为HTML标记，然后结合必要的XML命名空间声明，构造一个完整的HTML文档结构，最后通过设置特定的HTTP响应头，让浏览器将其识别并保存为Word文档。由于本质是发送HTML内容，因此在Word中打开时可能会显示“文件格式与扩展名不匹配”的警告，点击确定即可正常查看。

第1步：配置响应头与文件名处理

首先需要在代码中初始化 HTTP 响应对象，设置字符集和下载文件名。对于包含中文的文件名，必须进行 URL 编码，否则在非 IE 内核浏览器或特定环境下会出现乱码。

protected void Button1_Click(object sender, EventArgs e)
{
    string ExportFileName = "孟宪会导出 Word 测试";
    // 检查浏览器类型，如果是 MSIE (Internet Explorer) 需特殊处理
    if (Request.Browser.Browser.IndexOf("MSIE") > -1)
    {
        ExportFileName = HttpUtility.UrlEncode(ExportFileName, System.Text.UnicodeEncoding.GetEncoding("GB2312"));
    }
    ExportFileName += ".doc";

    Response.Clear();
    Response.BufferOutput = true;
    Response.ContentEncoding = System.Text.Encoding.GetEncoding("GB2312");
    Response.Charset = "GB2312";
    Response.AppendHeader("Content-Disposition", "attachment;filename=" + ExportFileName);
    Response.ContentType = "application/ms-word";
    Page.EnableViewState = false;
}

第2步：渲染控件为 HTML 字符串

使用 StringWriter 和 HtmlTextWriter 捕获控件的输出。需要分别获取页眉（Header）和数据列表（Repeater）的 HTML 内容。

System.IO.StringWriter stringWriter = new System.IO.StringWriter();
HtmlTextWriter textWriter = new HtmlTextWriter(stringWriter);

// 设置自定义标题
Literal header = new Literal();
header.Text = "<h2>文章标题</h2>";
Header.Controls.Add(header);
Header.RenderControl(textWriter);

// 渲染数据源控件
this.Repeater1.RenderControl(textWriter);

第3步：组装完整 HTML 并输出

为了确保 Word 能正确解析 VML（矢量图形语言）和其他 Office 特有属性，需要在输出内容前添加一组标准的 XML 命名空间声明。将包裹好的 HTML 内容写入 Response 并结束请求。

string htmlContent = "<html xmlns:v='urn:schemas-microsoft-com:vml' xmlns:o='urn:schemas-microsoft-com:office:office' xmlns:w='urn:schemas-microsoft-com:office:word' xmlns:m='http://schemas.microsoft.com/office/2004/12/omml' xmlns='http://www.w3.org/TR/REC-html40'><head></head><body lang=ZH-CN>";

Response.Write(htmlContent + stringWriter.ToString());
Response.End();
Response.Flush();
}

常见问题与排错

报错：Page.EnableViewState 必须在没有视图状态的情况下调用 RenderControl

在使用 ASP.NET 服务器控件进行外部渲染时，框架默认会校验控件是否在 <form runat=server> 内。由于我们是手动构建 HTML 流，并非直接在页面生命周期中渲染，因此必须重写页面的 VerifyRenderingInServerForm 方法以跳过此检查。

public override void VerifyRenderingInServerForm(System.Web.UI.Control control)
{
    // 空实现，跳过验证
}

以上就是C#导出文本内容到word文档的详细内容，更多关于C# ASP.NET开发及文件导出的资料请关注本站其它相关文章！