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

Base64嵌入範例

要在HTML中使用base64嵌入影像，您必須首先通過讀取影像文件或通過網路請求獲取影像的二進位數據。 使用Microsoft .NET的Convert.ToBase64String方法將二進位數據轉換為base64。在HTML中使用"data:image/svg+xml;base64,"來構造影像標籤。 您可能已注意到在base64數據之前指定了影像類型。 請參閱MDN Web Docs關於影像格式以獲取有關影像格式類型的更多信息。

: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 中嵌入圖像？

要在 PDF 中嵌入圖像，請在 HTML 文件中使用 <img> 標籤包含圖像。然後使用 IronPDF 的 RenderHtmlAsPdf 方法將這個 HTML 轉換為 PDF 文檔。

我在哪裡可以瞭解更多有關適用於 Base64 嵌入的圖像格式的資訊？

要獲得有關 Base64 嵌入的圖像格式類型的更多資訊，您可以參考 MDN Web Docs 上的圖像格式。此資源提供對不同類型圖像及其使用的詳細介紹。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

審核人
Jeff Fritz
Jeffrey T. Fritz
首席程序经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席程序经理。他是 .NET Conf 虚拟会议系列的执行制作人，并主持“Fritz 和朋友”这一每周两次的开发者的直播节目，在节目上讨论技术并与观众一起编写代码。Jeff 撰写研讨会、主持演讲，并计划大型 Microsoft 开发者活动（包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP Summit）的内容。
準備好開始了嗎？
Nuget 下載 16,154,058 | 版本： 2025.11 剛剛發布