1. IronPDF
  2. 操作指南
  3. SVG图形
如何使用 C# 将 SVG 转换为 PDF

Company Report

Curtis Chau
Curtis Chau
已更新:

用 C# 将 SVG 转换为 PDF IronPdf 采用 HTML 转 PDF 的方法将 SVG 图形转换为 PDF 文档--将 SVG 嵌入带有明确宽度/高度样式的 img 标签中，以确保正确渲染。 IronPDF 支持通过 HTML 转 PDF 方法将 SVG 图形渲染为 PDF 文档。 SVG（可缩放矢量图形）文件因其可缩放性和在任何尺寸下都能清晰呈现而被广泛用于徽标、图标、插图和图表。将 SVG 转换为 PDF 对于创建打印就绪的文档、存档以及确保在不同平台上显示一致至关重要。 注意：嵌入 SVG 时，请设置 **img** 元素的 **width** 和/或 **height** 样式属性，否则，它可能会折叠为零大小，并且不会出现在渲染的 PDF 中。 <！--说明：说明代码概念的图表或截图 --> *as-heading:2(快速入门：轻松将 SVG 转换为 PDF)* 使用 C# 中的 IronPDF 将 SVG 文件转换为 PDF。 该代码片段演示了如何通过带有指定尺寸的 HTML img 标签嵌入 SVG，这是成功渲染的关键步骤。 请按照本指南快速实施，以确保准确渲染 SVG 并将其保存为 PDF。 ```cs :title=Render an SVG to PDF in one line! new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.Rendering.WaitFor.RenderDelay(1000) } } .RenderHtmlAsPdf("Logo related to Company Report") .SaveAs("svgToPdf.pdf"); ```

最小工作流程（5 个步骤）

  1. 安装 IronPDF 库进行 SVG 到 PDF 的转换。
  2. 在 HTML 中使用 img 标记导入 SVG 图像
  3. 利用IronPDF中的不同渲染方法生成PDF
  4. 使用 SaveAs 方法保存包含 SVG 图像的 PDF 文件
  5. 检查指定位置的PDF

如何以正确的尺寸将 SVG 渲染为 PDF？ 许多浏览器允许使用 SVG，但没有尺寸规格； 然而，我们的渲染引擎需要它们。 IronPDF 使用的 Chrome 渲染引擎需要明确的尺寸才能正确渲染 SVG 元素。 如果没有指定尺寸，SVG 可能不会出现在最终的 PDF 中，或者在渲染时出现意外尺寸。 在 IronPDF 中处理 SVGs 时，有几种方法可以确保正确渲染： 1.**使用样式属性的内联 SVG**：直接在样式属性中添加宽度和高度 2.**外部 SVG 文件**：通过 URL 或本地文件路径引用 SVG 文件 3.**Base64 Encoded SVGs**：将 SVGs 作为 Base64 字符串直接嵌入 HTML 中 有关更多高级 HTML 渲染选项，请参阅我们的[渲染选项](https://ironpdf.com/how-to/rendering-options/)综合指南。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/SVGs-render.cs ```

生成的 PDF 看起来像什么？ 此外，或者作为替代方案，SVG 节点可以分配显式的宽度和高度属性。 另请参阅[CodePen上的SVG样式示例](https://codepen.io/AmeliaBR/pen/MYbzaW)。 ## 将 SVG 渲染为 PDF 示例 <！--说明：说明代码概念的图表或截图 --> ### 使用本地 SVG 文件 将本地 SVG 文件转换为 PDF 时，请使用文件路径方法。 这种方法可以很好地使用项目中存储的 SVG 资产： ```csharp using IronPdf; using System.IO; // Load SVG file content string svgPath = @"C:\assets\company-logo.svg"; string svgContent = File.ReadAllText(svgPath); // Create HTML with embedded SVG string html = $@"

Annual financial summary with vector graphics.

"; // Configure renderer with custom settings ChromePdfRenderer renderer = new ChromePdfRenderer(); renderer.RenderingOptions.MarginTop = 10; renderer.RenderingOptions.MarginBottom = 10; renderer.RenderingOptions.PrintHtmlBackgrounds = true; // Generate PDF PdfDocument pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs("report-with-svg.pdf"); ``` ### 嵌入式 SVG 的 Base64 编码 对于需要将 SVG 数据直接嵌入 HTML 而不需要外部文件引用的情况，Base64 编码提供了可靠的解决方案。 我们的[嵌入图片指南](https://ironpdf.com/how-to/add-images-to-pdfs/)将详细解释这种方法： ```csharp using IronPdf; using System; // SVG content as string string svgContent = @" "; // Convert to Base64 byte[] svgBytes = System.Text.Encoding.UTF8.GetBytes(svgContent); string base64Svg = Convert.ToBase64String(svgBytes); // Create HTML with Base64 embedded SVG string html = $@"

Embedded SVG Example

Svg+xml;base64,{base64Svg} related to Embedded SVG Example "; // Render to PDF ChromePdfRenderer renderer = new ChromePdfRenderer(); PdfDocument pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs("embedded-svg.pdf"); ``` ## 将 SVG 转换为 PDF 的最佳实践 ### 1.始终指定尺寸 将 SVG 转换为 PDF 时最常见的问题是尺寸缺失或为零。 始终确保您的 SVG 元素具有明确的宽度和高度值。 对于响应式设计，可考虑使用 [viewport 设置](https://ironpdf.com/how-to/viewport-zoom/) 来控制 PDF 布局。 ### 2.处理具有渲染延迟的复杂 SVG. 带有动画或 JavaScript 的复杂 SVG 文件可能需要额外的渲染时间。请使用 `RenderDelay` 选项以确保完整呈现： ```csharp renderer.RenderingOptions.WaitFor.RenderDelay(2000); // Wait 2 seconds ``` 有关高级 JavaScript 处理，请浏览我们的 [JavaScript 渲染指南](https://ironpdf.com/how-to/javascript-to-pdf/)。 ### 3.优化 SVG 文件 在转换之前，请通过以下方法优化 SVG 文件： - 删除不必要的元数据 - 简化路径 - 将文本转换为路径，以获得一致的渲染效果 - 使用适当的压缩 ### 4.测试跨平台兼容性 不同操作系统的 SVG 渲染可能会有所不同。 测试您的转换： - [Windows 环境](https://ironpdf.com/how-to/windows/)。 [Linux 系统](https://ironpdf.com/get-started/linux/) - [macOS 平台](https://ironpdf.com/how-to/macos/)。 ## 常见 SVG 问题的疑难解答 ### SVG 在 PDF 中不显示 如果您的 SVG 没有出现在生成的 PDF 中： 1.验证尺寸设置是否正确 2.检查文件路径或 URL 是否可访问 3.确保 SVG 文件的 MIME 类型正确 4.查看我们的[像素完美渲染指南](https://ironpdf.com/how-to/pixel-perfect-html-to-pdf/) ### 扩展和解析问题 用于不同比例的高质量 SVG 渲染： ```csharp // Set custom DPI for better quality renderer.RenderingOptions.DPI = 300; // Use CSS transforms for scaling string html = @" Logo related to Company Report"; ``` ### SVG 中的字体渲染 当 SVG 包含文本元素时，确保正确嵌入字体。 了解有关 [ 字体管理](https://ironpdf.com/how-to/manage-fonts/)和 [web 字体支持](https://ironpdf.com/how-to/webfonts-webicons/)的更多信息。 <！--说明：说明代码概念的图表或截图 --> ## 高级 SVG 转换技术 ### 批量处理多个 SVG. 用于将多个 SVG 文件转换为一个 PDF 文档： ```csharp using IronPdf; using System.Collections.Generic; using System.Text; List svgFiles = new List { "chart1.svg", "chart2.svg", "diagram.svg" }; StringBuilder htmlBuilder = new StringBuilder(); htmlBuilder.Append(""); foreach(string svgFile in svgFiles) { htmlBuilder.Append($@"
{svgFile} related to Company Report
"); } htmlBuilder.Append(""); ChromePdfRenderer renderer = new ChromePdfRenderer(); PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlBuilder.ToString()); pdf.SaveAs("multiple-svgs.pdf"); ``` 有关处理多个页面的更多信息，请参阅我们的[合并或拆分 PDF 指南](https://ironpdf.com/how-to/merge-or-split-pdfs/)。 准备好看看您还能做些什么吗？ 点击此处查看我们的教程页面：[附加功能](https://ironpdf.com/tutorials/pdf-assets-and-performance-csharp/)。 您还可以探索如何[在包含 SVG 的 PDF 中添加页眉和页脚](https://ironpdf.com/how-to/headers-and-footers/)，或了解[自定义水印](https://ironpdf.com/how-to/custom-watermark/)，以便为您的文档打上品牌。 - 使用 `TextAnnotation` 和 `AddTextAnnotation`

常见问题解答

如何用 C# 将 SVG 转换为 PDF？

IronPDF 使用 HTML 转 PDF 的方法将 SVG 转换为 PDF。只需将 SVG 嵌入带有明确宽度和高度样式的 HTML img 标签中，然后使用 IronPDF 的 ChromePdfRenderer 将 HTML 呈现为 PDF。关键是要确保在 img 元素上设置适当的尺寸属性。

为什么我的 SVG 没有出现在 PDF 中？

如果缺乏明确的宽度和高度规范，IronPDF 生成的 PDF 中可能不会出现 SVG。IronPdf 使用的 Chrome 渲染引擎要求通过样式属性或 img 标签上的宽度/高度属性来设置尺寸。如果没有这些属性，SVG 可能会折叠为零。

嵌入 SVGs 进行 PDF 转换的不同方法有哪些？

IronPDF 支持三种主要的 SVG 嵌入方法：1）带有宽度和高度样式属性的内联 SVG；2）通过 URL 或本地文件路径引用的外部 SVG 文件；3）直接嵌入 HTML 中的 Base64 编码 SVG。所有方法都需要适当的尺寸规格。

能否将本地 SVG 文件转换为 PDF？

是的，IronPDF 可以将本地 SVG 文件转换为 PDF。使用文件路径方法，通过 img 标签的rc 属性引用存储在项目中的 SVG 资产。切记要包含宽度和高度规格，以便正确渲染。

将 SVG 转换为 PDF 时应使用哪些渲染选项？

使用 IronPDF 将 SVG 转换为 PDF 时，请使用带有适当 RenderingOptions 的 ChromePdfRenderer。一种常见的方法是使用 WaitFor.RenderDelay(1000)添加渲染延迟（RenderDelay），以确保 SVG 在转换前完全加载。这有助于处理复杂的 SVG 或加载外部资源。

如何将转换后的 SVG 保存为 PDF 文件？

使用 IronPDF 的 ChromePdfRenderer 渲染包含 SVG 的 HTML 后，使用 SaveAs 方法保存 PDF 文件。只需在渲染的 PDF 对象上调用 SaveAs("filename.pdf") 即可将其保存到指定位置。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 17,012,929 | 版本: 2025.12 刚刚发布