使用CSS添加字体

Updated: 2026年6月29日

当通过CSS引用某个字体时，IronPDF会自动嵌入该字体，因此您可以使用自定义字体样式化文本，而无需直接调用任何字体API。将渲染器指向声明了字体的样式表，并在渲染期间拾取并嵌入该文件。

此示例通过RenderingOptions.CustomCssUrl设置自定义样式表并渲染Razor组件：

ChromePdfRenderer renderer = new ChromePdfRenderer();
Parameters.Add("persons", persons);
renderer.RenderingOptions.CustomCssUrl = $"wwwroot/css/custom.css";
PdfDocument pdf = renderer.RenderRazorComponentToPdf<Person>(Parameters);
File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData);

ChromePdfRenderer renderer = new ChromePdfRenderer();
Parameters.Add("persons", persons);
renderer.RenderingOptions.CustomCssUrl = $"wwwroot/css/custom.css";
PdfDocument pdf = renderer.RenderRazorComponentToPdf<Person>(Parameters);
File.WriteAllBytes("razorComponentToPdf.pdf", pdf.BinaryData);

@font-face规则声明字体，然后应用它：

@font-face {
   font-family: 'DancingScript';
   src: url('../fonts/DancingScript-Regular.ttf') format('truetype');
   font-weight: normal;
   font-style: normal;
}
body {
   font-family: 'DancingScript', Arial, sans-serif;
}

@font-face {
   font-family: 'DancingScript';
   src: url('../fonts/DancingScript-Regular.ttf') format('truetype');
   font-weight: normal;
   font-style: normal;
}
body {
   font-family: 'DancingScript', Arial, sans-serif;
}

Text

由于DancingScript-Regular.ttf，无需明确的注册步骤。