1. IronPDF
  2. 操作指南
  3. 图像（jpg、png、svg、gif等）
如何在 C# 中将图像添加到 PDF

How to Add Images to PDFs

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

在PDF中嵌入图像意味着将图像直接放入PDF文件中，确保其自包含且不依赖外部来源。 这使得PDF能够无缝显示图像，即使没有互联网连接或外部文件。

IronPDF能够将HTML字符串、文件和网页URL渲染为PDF。 通过使用此方法，可以将图像嵌入到HTML中，然后转换为PDF文档。

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

使用IronPDF在.NET C#中开始将图像嵌入PDF文件。 通过将图像转换为Base64字符串并嵌入到HTML <img> 标签中，可以生成不需要外部文件的自包含PDF。 此方法确保您的图像无需互联网访问即可无缝显示，使过程快速且简单。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer()
     .RenderHtmlAsPdf("<img src='data:image/png;base64," + Convert.ToBase64String(File.ReadAllBytes("logo.png")) + "'>")
     .SaveAs("image‑embedded.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

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

  1. 下载IronPDF C#库
  2. 准备要嵌入的图像文件
  3. 使用img标签在HTML中嵌入图像
  4. 使用RenderHtmlAsPdf方法将HTML渲染为PDF
  5. 使用Base64编码嵌入图像


在PDF中嵌入图像示例

要在PDF中嵌入图像，您必须首先使用<img>标签将图像包含在HTML中。 然后，使用RenderHtmlAsPdf方法将HTML转换为PDF。 如果您已有PDF，可以使用图像印章或HTML印章教程将图像盖在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");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export PDF
pdf.SaveAs("embedImage.pdf")
$vbLabelText   $csharpLabel

<hr

Base64嵌入示例

要使用base64在HTML中嵌入图像，您必须首先通过读取图像文件或通过网络请求获取图像的二进制数据。使用Microsoft .NET中的Convert.ToBase64String方法将二进制数据转换为base64。在HTML中构建图像标签时在base64数据之前使用"data:image/svg+xml;base64,"。 您可能已经注意到，在base64数据之前会指定图像类型。 访问MDN Web文档上的图像格式类型以获取有关图像格式类型的更多信息。

: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");
Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

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

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("embedImageBase64.pdf")
$vbLabelText   $csharpLabel

准备好看看您还能做些什么吗？ 查看我们的教程页面：额外功能

常见问题解答

如何使用 C# 将图像添加到 PDF 中？

您可以通过使用 IronPDF 在 C# 中将图像添加到 PDF。首先，下载 IronPDF C# 库。然后，准备图像文件并使用 <img> 标签在 HTML 中嵌入它。最后，使用 RenderHtmlAsPdf 方法将 HTML 转换为 PDF。

在 PDF 中使用 Base64 编码图像有什么好处？

Base64 编码允许您将图像数据直接嵌入到 HTML 中。这意味着在 PDF 中显示图像时无需单独的图像文件或网络请求，确保 PDF 是自包含的。

我可以在现有 PDF 文档中添加图像吗？

可以，您可以通过在文档上加盖图像来向现有 PDF 添加图像。IronPDF 提供了使用图像盖章器或 HTML 盖章器实现此目的的教程。

将图像二进制数据转换为 Base64 的过程是什么？

要将图像二进制数据转换为 Base64，请使用 Microsoft 的 .NET Convert.ToBase64String 方法。转换后，您可以将 Base64 字符串嵌入到 HTML <img> 标签中，并通过 IronPDF 将其渲染为 PDF。

PDF 中嵌入的图像需要互联网连接才能显示吗？

不，图像一旦嵌入到 PDF 中，就不需要互联网连接来显示。这是因为这些图像包含在 PDF 文件本身中。

如何使用 HTML 和 IronPDF 在 PDF 中嵌入图像？

要使用 HTML 在 PDF 中嵌入图像，请在 HTML 文件中使用 <img> 标签包含图像。然后，使用 IronPDF 的 RenderHtmlAsPdf 方法将该 HTML 转换为 PDF 文档。

我可以在哪里了解更多关于 Base64 嵌入使用的图像格式的信息？

有关 Base64 嵌入使用的图像格式类型的更多信息，您可以参考 MDN Web Docs 上的图像格式文档。这一资源提供了关于不同图像类型及其使用的详细信息。

IronPDF 在处理图像和 HTML 渲染时是否与 .NET 10 完全兼容？

是的。IronPDF 完全兼容 .NET 10，包括其图像嵌入和 HTML 转 PDF 渲染功能。它支持图像、CSS 和 JavaScript 等外部资源，并且可以在 .NET 10 项目中开箱即用。

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

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

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

审核者
Jeff Fritz
Jeffrey T. Fritz
首席项目经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席项目经理。他是 .NET Conf 虚拟会议系列的执行制片人，并主持“Fritz and Friends”直播节目，每周两次与观众一起谈论技术并编写代码。Jeff 撰写研讨会、演示文稿并计划包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP 峰会在内的最大型微软开发者活动的内容。
准备开始了吗？
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布