如何使用 IronPDF 在 C# 中为 PDF 添加图像

为什么 RenderHtmlAsPdf 方法效果最好？

RenderHtmlAsPdf 方法利用 IronPDF 的 Chrome 渲染引擎将 HTML 内容(包括图像)转换为 PDF 格式，同时保留布局和样式。 这种方法支持响应式 CSS 布局，并确保图片能像在网络浏览器中显示的那样呈现。 对于复杂的布局，请参阅我们的像素完美的 HTML 格式化指南。

支持哪些图像格式？

通过 HTML 转换嵌入时，IronPDF 支持所有主流图像格式，包括 PNG、JPG、SVG、GIF 和 BMP。 该库可有效处理 SVG 图形，用于可缩放的矢量插图。 使用不同格式时，请确保 HTML 在 src 属性或 Base64 数据 URI 中正确指定图像类型。

何时应使用直接 URL 与 Base64 编码？

如果图片是在线托管的，且文件大小是个问题，请使用直接 URL。 对于不需要互联网访问的独立 PDF，请选择 Base64 编码。 对于存储在云服务中的图像，请参阅我们的从 Azure Blob Storage 嵌入图像指南。 这一决定会影响生成 PDF 的文件大小和可移植性。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

为什么对图像使用 Base64 编码？

Base64 编码可创建不依赖外部资源的独立 PDF，确保在没有互联网连接或原始图像文件被移动或删除的情况下始终显示图像。 当在 Blazor Server 应用程序中创建 PDF 或部署到外部文件访问可能受限的 Azure 时，此技术非常有用。 编码后的图像成为 HTML 字符串的一部分，因此非常适合 HTML 字符串到 PDF 的转换。

性能考虑因素有哪些？

Base64 编码会使文件大小增加约 33%，但消除了外部依赖性，因此非常适合存档或受限制的网络环境。 当性能至关重要时，可考虑使用 async PDF 生成来并发处理多个图像转换。 对于大规模操作，请参阅我们的性能优化指南，以最大限度地提高吞吐量。

如何处理大型图像文件？

对于大型图片，请在进行 Base64 编码之前对其进行压缩，以尽量减小 PDF 文件的大小，如果文件大小至关重要，则使用外部 URL。 IronPDF 提供PDF压缩功能，可将文件大小缩小 75%。 在处理多张图片时，请优化您的渲染设置，以实现质量和文件大小之间的最佳平衡。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

准备好看看您还能做些什么吗？ 点击此处查看我们的教程页面：附加功能。