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

IronPDF 通过将包含图像标记的 HTML 转换为 PDF 文档，实现了将图像直接嵌入 PDF 的功能，从而创建了无需外部依赖性或互联网连接即可显示图像的独立文件。

快速入门：轻松将图像嵌入PDF

使用 IronPDF for .NET C# 开始在 PDF 文件中嵌入图像。 将图像转换为 Base64 字符串并嵌入 HTML <img> 标记，生成无需外部文件的自包含 PDF。 这种方法可确保您的图像在没有互联网接入的情况下也能显示。

如何在 PDF 中嵌入图片？ <！--说明：说明代码概念的图表或截图 --> 要在 PDF 中嵌入图片，首先要使用 `` 标记将图片包含在 HTML 中。 然后使用 `RenderHtmlAsPdf` 方法将 HTML 转换为 PDF。 如果您已有 PDF 文档，请使用 [图像标注器或 HTML 标注器教程](/how-to/自定义水印/)将图像标注到 PDF 文档上。 这种方法可与 IronPdf 的[Chrome 渲染引擎](https://ironpdf.com/how-to/ironpdf-2021-chrome-rendering-engine-eap/)配合使用。

为什么 RenderHtmlAsPdf 方法效果最好？ `RenderHtmlAsPdf` 方法利用 IronPDF 的 Chrome 渲染引擎将 HTML 内容（包括图片）转换为 PDF 格式，同时保留布局和样式。 这种方法支持[响应式 CSS 布局](https://ironpdf.com/how-to/html-to-pdf-responsive-css/)，并确保图片能像在网络浏览器中显示的那样呈现。 对于复杂的布局，请参阅我们的[像素完美的 HTML 格式化](https://ironpdf.com/tutorials/pixel-perfect-html-to-pdf/)指南。

支持哪些图像格式？ 通过 HTML 转换嵌入时，IronPDF 支持所有主流图像格式，包括 PNG、JPG、SVG、GIF 和 BMP。 该库可有效处理 [SVG 图形](https://ironpdf.com/how-to/SVGs/)，用于可缩放的矢量插图。 在使用不同格式时，请确保您的 HTML 在 `src` 属性或 Base64 数据 URI 中正确指定了图像类型。

何时应使用直接 URL 与 Base64 编码？ 如果图片是在线托管的，且文件大小是个问题，请使用直接 URL。 对于不需要互联网访问的独立 PDF，请选择 Base64 编码。 对于存储在云服务中的图像，请参阅我们的[从 Azure Blob Storage 嵌入图像](https://ironpdf.com/how-to/images-azure-blob-storage/)指南。 这一决定会影响生成 PDF 的文件大小和可移植性。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs ```

---

--> <！--说明：说明代码概念的图表或截图 -->

如何使用 Base64 嵌入图片？ 要使用 Base64 在 HTML 中嵌入图像，首先要通过读取图像文件或通过网络请求接收图像来获取图像的二进制数据。使用 .NET 中的 `Convert.ToBase64String` 方法将二进制数据转换为 Base64。在 Base64 数据前使用 "data:image/svg+xml;base64 "来构建 HTML 中的图像标记。 请注意，图像类型是在 Base64 数据之前指定的。 访问[MDN Web文档上的图像格式类型](https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types)以获取有关图像格式类型的更多信息。

为什么对图像使用 Base64 编码？ Base64 编码可创建不依赖外部资源的独立 PDF，确保在没有互联网连接或原始图像文件被移动或删除的情况下始终显示图像。 当[在 Blazor Server 应用程序中创建 PDF](https://ironpdf.com/how-to/blazor-tutorial/) 或[部署到外部文件访问可能受限的 Azure](https://ironpdf.com/how-to/azure/) 时，此技术非常有用。 编码后的图像成为 HTML 字符串的一部分，因此非常适合 [HTML 字符串到 PDF 的转换](https://ironpdf.com/how-to/html-string-to-pdf/)。

性能考虑因素有哪些？ Base64 编码会使文件大小增加约 33%，但消除了外部依赖性，因此非常适合存档或受限制的网络环境。 当性能至关重要时，可考虑使用 [async PDF 生成](https://ironpdf.com/how-to/async/)来并发处理多个图像转换。 对于大规模操作，请参阅我们的[性能优化指南](https://ironpdf.com/tutorials/pdf-assets-and-performance-csharp/)，以最大限度地提高吞吐量。

如何处理大型图像文件？ <！--说明：说明代码概念的图表或截图 --> 对于大型图片，请在进行 Base64 编码之前对其进行压缩，以尽量减小 PDF 文件的大小，如果文件大小至关重要，则使用外部 URL。 IronPDF 提供[PDF压缩](https://ironpdf.com/how-to/pdf-compression/)功能，可将文件大小缩小 75%。 在处理多张图片时，[请优化您的渲染设置](https://ironpdf.com/how-to/rendering-options/)，以实现质量和文件大小之间的最佳平衡。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs ``` 准备好看看您还能做些什么吗？ 点击此处查看我们的教程页面：[附加功能](https://ironpdf.com/tutorials/pdf-assets-and-performance-csharp/)。