C# 添加影像至 PDF（開發者教學）

介紹

從開發者的角度來看，程式化地向 PDF 文件中添加圖像是一項具有挑戰性的任務，這是由於圖像格式的多樣性及其操作的複雜性所致。 因此，建議使用 IronPDF C# 函式庫以程式化方式將圖像添加到 PDF 文件中。 讓我們來探索什麼是 IronPDF 及如何有效地使用它。

IronPDF：C# PDF 庫

IronPDF C# 庫是一個以 C# 編寫並針對 PDF 物件模型的 PDF 庫。 此函式庫為開發者提供了一種方法，可以創建、編輯和儲存 PDF 文件，而不需要與特定的 API（如 Adobe 的 Acrobat）保持緊密相關。 IronPDF C# 库可以在您不想使用 Adobe Acrobat 或其他单独的软件时使用。

此庫為開發人員提供了許多工具，用於創建、使用C#編輯PDF文件，並保存PDF文件和其他.NET PDF庫不具備的功能。 許多開發者偏好使用 IronPDF C# 程式庫，因為它在 Windows、Linux 和 macOS 平台上提供了他們在 PDF 程式庫中所尋找的一切，而且完全免費！ IronPDF 不斷新增功能並擴展其服務，以成為滿足您的 PDF 需求的最佳工具。 該程式庫超越了基本需求，非常適合需要瀏覽、搜尋、查找、從 PDF 檔案中提取數據或創建 PDF 檔案的人員。 讓我們來看看如何使用IronPDF將圖像添加到 PDF 文檔中。

建立或開啟 C# 專案

要將圖像添加到 PDF 文檔中，建議使用最新版的 Visual Studio 創建 C# 專案，以獲得順暢的體驗。

• 打開 Visual Studio。

  

  Visual Studio 啟動 UI

• 點擊「創建新項目」按鈕。

• 從專案模板中選擇「C# 主控台應用程式」，然後點擊下一步按鈕。 您可以根據需要選擇適合的平台。

  

  在 Visual Studio 中建立主控台應用程式

• 接下來，為您的專案命名，然後點擊下一步按鈕。

• 選擇目標 .NET Framework >= .NET Core 3.1 版本，然後點擊建立按鈕。

  通過遵循上述步驟，您將能夠輕鬆地創建一個新的 C# 項目。 您可以使用現有的 C# 專案。 只需打開專案並安裝IronPDF庫。

安裝 IronPDF 函式庫

IronPDF 庫可以通過多種方式安裝。

• 使用 NuGet 套件管理器
• 使用套件管理控制台

使用 NuGet 套件管理器

若要使用 NuGet 套件管理器安裝該庫，請按照以下步驟進行：

• 從主選單選項中，轉到 工具 > NuGet 套件管理員 > 管理方案的 NuGet 套件。

  

  導航至 NuGet 套件管理器

• 這將開啟 NuGet 套件管理器窗口。 前往瀏覽標籤並搜尋IronPDF。 選擇IronPDF庫，然後點擊「安裝」按鈕。

  

  從 NuGet 套件管理器安裝 IronPdf 套件

使用套件管理器控制台

以下是在控制台中安裝 IronPDF 程式庫的步驟。

• 前往套件管理器主控台（通常位於 Visual Studio 的底部）。
• 輸入以下指令以開始安裝 IronPDF 程式庫。

Install-Package IronPdf

這將開始安裝，您將能夠看到安裝的進度。 安裝後，您將能夠非常快速地在項目中使用IronPDF庫。

該庫已安裝，現在是時候編寫代碼將圖像添加到 PDF 文件中。 首先導入 IronPDF 命名空間。 因此，在您的代碼檔中寫入以下行：

using IronPdf;

using IronPdf;

Imports IronPdf

將位圖和圖像添加到 PDF 文件中

使用 IronPDF 有多種將影像添加到 PDF 文件的方法：使用直接影像檔案、將影像轉換為位元組，或使用 System.Drawing.Bitmap。 此外，IronPDF 庫支援多種影像格式。

讓我們來看看：

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

Imports IronPdf
Imports System.IO
Imports System.Drawing
' Example 1: From an Image File or Bytes

Shared Sub Main(ByVal args() As String)
	Dim renderer = New IronPdf.ChromePdfRenderer()

	Dim pngBinaryData = File.ReadAllBytes("embed_me.png")

	Dim ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(base64bytes)
	Dim ImgHtml = $"<img src='{ImgDataURI}'>"

	Dim pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml)
	pdfdoc.SaveAs("embeded_example_1.pdf")
End Sub

此程式將首先載入影像。上述程式碼中的ReadAllBytes函數將影像轉換為位元組格式。 之後，影像資料將被編碼成 base64，並作為字串放置於 HTML 標籤中。 之後，HTML 字串將使用RenderHtmlAsPdf 方法 函數呈現為 PDF。 它將在 PDF 文件中建立一個 PDF 頁面。

下一個範例將展示如何在 PDF 文件中使用 Bitmap 圖像。 IronPDF 有一個有效的方法可以將 System.Drawing.Image 嵌入到 HTML 文件中，然後可將其呈現為 PDF。 請訪問以下ImageUtilities API以了解更多資訊。 以下程式碼將顯示其運作方式：

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

' Example 2: From a System.Drawing.Bitmap 

'System.Drawing.BitMap MyImage

Dim DataURI As String = IronPdf.Util.ImageToDataUri(MyImage)
Dim ImgHtml = $"<img src='{DataURI}'>"
Dim pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml)
pdfdoc2.SaveAs("emeded_example_2.pdf")

在上述代碼中，ImageToDataUri 函數用於將其轉換為 URI，然後操作員使用 RenderHtmlAsPdf 函數將圖像繪製到 PDF 文件中。 這適用於多個圖像。

此外，IronPDF 還能夠在 PDF 中渲染圖表，將條碼添加到 PDF 文檔中，通過密碼增強 PDF 的安全性，給 PDF 文件添加水印，甚至以程式化方式處理 PDF 表單。

授權

IronPDF 是一個出色的 PDF 程式庫，可幫助您創建和自定義 PDF 文件，您可立即購買。 然而，IronPDF 完全免費供開發用途使用。 您也可以啟用免費試用版本，無需提供任何付款詳情即可用於生產。 購買 IronPDF 後，Iron Software 為您提供了一個絕佳的優惠，讓您以兩個的價格購買五個 Iron Software 套件。 是的！ 你沒聽錯——你可以以兩個產品的價格購買五個 Iron Software 產品套件。 立即購買！ 請造訪IronPDF 授權頁面以獲取更多詳情。