如何使用IronPDF在 C# 中為 PDF 新增圖像

為什麼 RenderHtmlAsPdf 方法效果最佳？

RenderHtmlAsPdf 方法利用 IronPDF 的 Chrome 渲染引擎將 HTML 內容(包括圖像)轉換為 PDF 格式，同時保留佈局和樣式。 此方法支援響應式 CSS 佈局，並確保圖像在 Web 瀏覽器中呈現效果與實際顯示效果一致。 對於複雜的佈局，請參閱我們的像素級完美 HTML 格式指南。

支援哪些圖像格式？

IronPDF支援所有主流影像格式，包括 PNG、JPG、SVG、GIF 和 BMP，可透過 HTML 轉換嵌入。 該函式庫能夠有效地處理SVG 圖形，實現可縮放的向量插圖。 使用不同格式時，請確保 HTML 在 src 屬性或 Base64 資料 URI 中正確指定影像類型。

何時應該使用直接URL，何時應該使用Base64編碼？

當圖片託管在網路上且檔案大小是考慮因素時，請使用直接 URL。 對於不需要網路存取的獨立 PDF 文件，請選擇 Base64 編碼。 儲存在雲端服務中的映像，請參閱我們關於嵌入 Azure Blob 儲存影像的指南。 此決定會影響所產生 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%，但消除了外部依賴項，因此非常適合用於歸檔或受限的網路環境。 當效能至關重要時，可以考慮使用非同步 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");

準備好要看看你還能做什麼了嗎？ 請造訪我們的教學頁面：附加功能