如何使用 IronPDF 在 C# 中為 PDF 添加圖片。

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

快速入門：輕鬆地將圖像嵌入 PDF

在 .NET C# 中使用 IronPDF 開始在 PDF 檔案中嵌入圖片。 將您的圖片轉換為 Base64 字串，並將其嵌入 HTML <img> 標籤中，以產生不需要外部檔案的獨立 PDF。 此方法可確保您的圖片在沒有網際網路存取的情況下也能顯示。

如何在 PDF 中嵌入圖片？ <！--說明：說明程式碼概念的圖表或截圖 --> 若要在 PDF 中嵌入圖片，首先使用 `` 標籤將圖片包含在 HTML 中。 然後使用 `RenderHtmlAsPdf` 方法將 HTML 轉換為 PDF。 如果您有現有的 PDF，請使用 [image stamper 或 HTML stamper 教學](/how-to/custom-watermark/)，將圖像印在 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/)，並確保圖像能如網頁瀏覽器所顯示的一樣呈現。 如需複雜的版面設計，請參閱我們的 [pixel-perfect 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 vs 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 Docs 上的"影像格式"](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/)。