Asp.Net中使用iTextSharp生成PDF时页面拆分且丢失内联CSS的解决方法

这个问题我之前也碰到过！核心原因是你用的HTMLWorker是iText官方早已弃用的组件，它对CSS的支持极其有限——几乎完全不处理内联样式，所以你的表格背景色、边框、宽度这些样式全丢了，才会出现页面布局错乱的情况。

解决方案：改用XML Worker处理HTML/CSS #

iText从5.x版本开始就推荐用XML Worker替代HTMLWorker，它对HTML和CSS的支持完善得多，能正确解析内联样式、表格属性等。以下是修改后的完整可运行代码：

using iTextSharp.text;
using iTextSharp.text.pdf;
using iTextSharp.tool.xml; // 需引用iTextSharp.xmlworker NuGet包

// 配置PDF响应头
Response.ContentType = "application/pdf";
Response.AddHeader("content-disposition", "attachment;filename=TestPage.pdf");
Response.Cache.SetCacheability(HttpCacheability.NoCache);

// 渲染Panel为HTML字符串
StringWriter sw = new StringWriter();
HtmlTextWriter hw = new HtmlTextWriter(sw);
// 可选：指定编码避免特殊字符乱码（比如土耳其语字符）
hw.Encoding = System.Text.Encoding.UTF8;
pnlPerson.RenderControl(hw);
string htmlContent = sw.ToString();

// 初始化PDF文档
Document pdfDoc = new Document(PageSize.A4, 10f, 10f, 100f, 0f);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, Response.OutputStream);
pdfDoc.Open();

// 使用XML Worker解析HTML及内联CSS
using (StringReader sr = new StringReader(htmlContent))
{
    XMLWorkerHelper.GetInstance().ParseXHtml(writer, pdfDoc, sr);
}

pdfDoc.Close();
Response.End();

关键修改说明 #

1. 替换核心解析组件：移除过时的HTMLWorker，用XMLWorkerHelper替代，它能正确识别你HTML里的内联样式（背景色、边框、表格宽度等）
2. 修复无效代码：原代码最后Response.Write(pdfDoc);是错误的——pdfDoc是文档对象而非字节流，且PDF内容已经直接写入Response.OutputStream，这行代码完全多余且会报错
3. 资源优化：用using语句包裹StringReader，确保IO资源正确释放

额外注意事项 #

• 需通过NuGet安装两个依赖包：iTextSharp和iTextSharp.xmlworker（针对.NET Framework项目）
• 如果你的HTML包含非英文字符，一定要指定编码（如示例中的UTF8），避免乱码

内容的提问来源于stack exchange，提问作者Can Çalışkan