如何使用IronPDF在C#中將圖像添加到PDF中

Curtis Chau
Curtis Chau
已更新: 2026年8月2日

IronPDF 可透過將含圖片標籤的 HTML 轉換為 PDF 文件,直接將圖片嵌入 PDF 中,建立可顯示圖片的獨立檔案,無需外部依賴或網際網路連線。

快速入門:輕鬆將圖像嵌入到PDF中

開始在.NET C#中使用IronPDF將影像嵌入PDF文件。 將您的影像轉換為Base64字串,並將其嵌入HTML中的<img>標籤,以生成無需外部文件的自包含PDF。 此方法可確保您的圖片在沒有網際網路存取的情況下也能顯示。

  1. 1使用 IronPDF 安裝 NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2複製並運行這段程式碼。

    new IronPdf.ChromePdfRenderer()
         .RenderHtmlAsPdf("<img src='data:image/png;base64," + Convert.ToBase64String(File.ReadAllBytes("logo.png")) + "'>")
         .SaveAs("image-embedded.pdf");
  3. 3部署到您的生產環境進行測試

    立即在您的項目中開始使用 IronPDF,並使用 免費試用
    arrow pointer

如何將影像嵌入PDF?

要將影像嵌入PDF,首先使用<img>標籤將影像放入HTML中。 然後使用RenderHtmlAsPdf方法將HTML轉換為PDF。 如果有現有的PDF,使用圖片蓋章器或HTML蓋章器教程將圖片蓋在PDF文件上。 此方法可與IronPDF的Chrome渲染引擎一起使用。

為什麼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 的檔案大小和可攜性。

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");

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能,例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000,同時提高生產力,釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官,OPYN

查看案例研究

如何使用Base64嵌入影像?

要在HTML中使用Base64嵌入影像,首先透過讀取影像文件或接收網路請求來獲取影像的二進位資料。使用.NET中的Convert.ToBase64String方法將二進位資料轉換為Base64。在HTML中使用"data:image/svg+xml;base64,"構建影像標籤,置於Base64資料之前。 請注意,影像類型是在 Base64 資料之前指定的。 造訪MDN網頁文件:影像格式以獲取更多影像格式類型的信息。

為什麼要使用Base64編碼影像?

Base64 編碼可建立不依賴外部資源的獨立 PDF,確保影像在沒有網際網路連線或原始影像檔案被移動或刪除時仍能顯示。 此技術在Blazor Server應用程式中創建PDF或在部署到Azure時外部文件訪問可能受限時非常有用。 編碼後的影像成為HTML字串的一部分,這使得它們非常適合HTML字串轉至PDF轉換。

有哪些性能考量?

Base64 編碼會增加約 33% 的檔案大小,但可消除外部依賴性,因此非常適合歸檔用途或受限制的網路環境。 當性能至關重要時,考慮使用異步PDF生成來同時處理多個影像轉換。 對於大型操作,請參閱我們的性能優化指南以最大化吞吐量。

如何處理大型影像文件?

對於大型圖片,請在 Base64 編碼前先壓縮圖片,以盡量減少 PDF 檔案大小,如果檔案大小非常重要,請使用外部 URL。 IronPDF提供PDF壓縮功能,可減少多達75%的文件大小。 處理多個影像時,優化您的渲染設置以在質量與文件大小之間達到最佳平衡。

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");

準備好看看您還能做些什麼嗎? 查看我們的教程頁面:其他功能

常見問題

如何使用C#和IronPDF將圖片嵌入PDF中?

要在PDF中嵌入圖片,使用IronPDF的HTML圖片標籤與IronPDF的Chrome渲染引擎。將圖片轉換為Base64字串並嵌入HTML的 <img> 標籤中。然後,使用 RenderHtmlAsPdf 方法將HTML渲染為自包含的PDF。

IronPDF在將圖片嵌入到PDF時支持哪些圖片格式?

IronPDF支持在PDF中嵌入多種圖片格式,包括PNG、JPG、SVG、GIF和BMP,通過使用HTML轉換技術。確保您的HTML在 src 屬性或Base64資料URI中指定正確的圖片類型。

`RenderHtmlAsPdf` 方法為什麼在嵌入PDF中的圖片時被優先選擇?

RenderHtmlAsPdf 方法被優先選擇是因為它利用了IronPDF的Chrome渲染引擎來準確地將HTML內容,包括樣式和圖片,轉換為PDF格式。此方法支持響應式佈局,並確保圖片如同在網頁瀏覽器中見到的一樣正確渲染。

什麼時候應該在PDF中使用Base64編碼而不是直接使用URL來表示圖片?

當創建不需要網路存取的自包含的PDF時,應使用Base64編碼來顯示圖片。這在離線環境或圖片文件可能無法持久提供的環境中特別有用。直接URL適合於圖片在線託管,且文件大小是個考量因素的時候。

使用Base64編碼圖片有哪些性能考量?

使用Base64編碼圖片的文件大小會增加約33%,但消除了對外部圖片的依賴。這在創建可靠且易於攜帶的PDF特別理想,特別是在網路存取受限的環境中。為提高性能,可考慮非同步的PDF生成。

IronPDF如何協助將大型圖片嵌入PDF中?

對於嵌入大型圖片,考慮在將圖片編碼成Base64之前進行壓縮以減少PDF大小。IronPDF提供了PDF壓縮功能,以幫助在質量和文件大小之間維持最佳平衡。

IronPDF能否與Blazor Server應用程式一同用於創建PDF?

是的,IronPDF可以用於Blazor Server應用程式來創建PDF。通過使用Base64或其他技術嵌入圖片,您可以確保PDF是自包含的,不依賴於外部資源,適合伺服器端的環境。

IronPDF能否在將圖片嵌入PDF中時處理SVG圖形?

是的,IronPDF可以有效地處理SVG圖形將其嵌入PDF中。通過使用 RenderHtmlAsPdf 方法轉換包含SVG的HTML,可以保留向量插圖的可縮放性和質量。

IronPDF如何優化含多個圖片的PDF的渲染?

IronPDF通過使用高級設置和壓縮技術來優化渲染。對於多個圖片,可以調整渲染設置以達到圖片質量與PDF文件大小的最佳平衡。請參考優化指南以獲得更全面的策略。

Base64編碼在將圖片嵌入PDF文件時提供了哪些優勢?

Base64編碼提供的優勢是創建自包含的PDF,確保圖片無論外部資源的可用性如何都能一致顯示。這在離線場景或嵌入需要安全處理的敏感圖片時特別有利。

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

閱讀更多

準備好開始了嗎?

NuGet 下載次數 22,198,312版本:2026.11剛剛發布