使用EvoPDF转换ASP.NET MVC页面为PDF时如何应用自定义外部CSS？

当然可行！EvoPDF虽然没有直接命名为Styles的属性，但提供了好几种方式来应用自定义CSS，甚至能实现只在PDF转换时生效的特定样式，下面是我常用的几个方案：

EvoPDF的HtmlToPdfConverter类自带CustomCss属性，你可以把外部CSS文件的内容读取成字符串，赋值给这个属性——这样转换PDF时会自动应用这些样式，完全不会影响页面的正常浏览器显示。

示例代码（ASP.NET MVC控制器中）：

public ActionResult ConvertToPdf()
{
    // 初始化PDF转换器
    HtmlToPdfConverter pdfConverter = new HtmlToPdfConverter();
    
    // 读取外部自定义CSS文件内容
    string customPdfCss = System.IO.File.ReadAllText(Server.MapPath("~/Content/PdfExclusiveStyles.css"));
    
    // 给转换器绑定自定义CSS
    pdfConverter.CustomCss = customPdfCss;
    
    // 设置要转换的目标页面URL（这里用当前MVC视图的完整URL）
    string targetUrl = Url.Action("YourTargetView", "YourController", null, Request.Url.Scheme);
    
    // 执行转换并获取PDF字节流
    byte[] pdfBytes = pdfConverter.ConvertUrl(targetUrl);
    
    // 返回PDF文件供下载
    return File(pdfBytes, "application/pdf", "ConvertedDocument.pdf");
}

EvoPDF的转换器在请求页面时，会发送特定的User Agent标识（格式类似EvoPDF Html to Pdf Converter vX.X，X是版本号）。你可以在MVC视图里检测这个标识，只在转换时加载专属的CSS文件。

示例Razor视图代码：

@{
    var userAgent = Request.UserAgent;
    // 检测是否是EvoPDF发起的请求
    if (!string.IsNullOrEmpty(userAgent) && userAgent.Contains("EvoPDF"))
    {
        <link href="@Url.Content("~/Content/PdfOnlyStyles.css")" rel="stylesheet" type="text/css" />
    }
}

这种方式的好处是，用户正常访问页面时不会加载这份CSS，只有PDF转换过程中才会应用，完全隔离了两种场景的样式。

如果你的内容是直接生成的HTML字符串（比如从视图渲染得到的字符串），可以在转换前把自定义CSS直接注入到HTML的<head>标签里。

示例代码：

public ActionResult ConvertHtmlToPdf()
{
    HtmlToPdfConverter pdfConverter = new HtmlToPdfConverter();
    
    // 把目标视图渲染成HTML字符串（需要一个辅助方法）
    string rawHtml = RenderViewToString("YourView", yourViewModel);
    
    // 读取自定义CSS内容
    string pdfCss = System.IO.File.ReadAllText(Server.MapPath("~/Content/PdfCustomStyles.css"));
    
    // 将CSS注入到HTML的head部分
    string styledHtml = rawHtml.Replace("</head>", $"<style>{pdfCss}</style></head>");
    
    // 转换处理后的HTML字符串
    byte[] pdfBytes = pdfConverter.ConvertHtml(styledHtml, null);
    
    return File(pdfBytes, "application/pdf", "StyledPdf.pdf");
}

// 辅助方法：将MVC视图渲染为字符串
private string RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var stringWriter = new StringWriter())
    {
        var viewResult = ViewEngines.Engines.FindPartialView(ControllerContext, viewName);
        var viewContext = new ViewContext(ControllerContext, viewResult.View, ViewData, TempData, stringWriter);
        viewResult.View.Render(viewContext, stringWriter);
        viewResult.ViewEngine.ReleaseView(ControllerContext, viewResult.View);
        return stringWriter.GetStringBuilder().ToString();
    }
}

额外小提示 #

• 记得用Server.MapPath获取CSS文件的绝对路径，避免因相对路径导致找不到文件的问题。
• 如果需要覆盖页面原有样式，优先用更具体的CSS选择器提升权重，尽量少用!important。
• 可以通过pdfConverter.CustomCssMediaType属性设置媒体类型为"print"，让转换时自动应用打印样式规则。

内容的提问来源于stack exchange，提问作者Twelve