跳過到頁腳內容
使用IRONPDF

C#將圖像添加到PDF(開發者教程)

從開發人員的角度來看,由於影像格式的多樣性和操作的複雜性,以程式設計方式為 PDF 文件添加影像是一項具有挑戰性的任務。 因此,建議使用 IronPDF C# 庫以程式設計方式為 PDF 文件添加影像。 讓我們一起來了解一下IronPDF是什麼以及如何有效地使用它。

IronPDF:C# PDF 函式庫

IronPDF C# 函式庫是一個用 C# 寫的 PDF 函式庫,目標模型是 PDF 物件模型。 該程式庫為開發人員提供了一種創建、編輯和保存 PDF 文件的方法,而無需與 Adobe Acrobat 等特定 API 保持緊密的關聯性。 當您不想使用 Adobe Acrobat 或其他單獨的軟體時,可以使用 IronPDF C# 程式庫。

該程式庫為開發人員提供了大量工具,用於使用 C# 建立和編輯 PDF 文件,以及保存 PDF 文件,並且還提供了其他 .NET PDF 庫不提供的功能。 許多開發人員更喜歡 IronPDF C# 庫,因為它在 Windows、Linux 和 macOS 平台上提供了他們想要的 PDF 庫的所有功能,而且完全免費! IronPDF不斷增加功能並擴展服務,使其成為滿足您PDF需求的最佳實用工具。 對於需要瀏覽、搜尋、尋找、從 PDF 文件中提取資料或建立 PDF 文件的使用者來說,該圖書館的功能遠遠超出基本要求。 讓我們來看看如何使用 IronPDF 將影像新增到 PDF 文件中。

建立或開啟 C# 項目

若要為 PDF 文件中新增影像,建議使用最新版本的 Visual Studio 建立 C# 項目,以獲得流暢的體驗。

  • 開啟 Visual Studio。

如何使用 C# 在 PDF 中新增影像,圖 1:Visual Studio 啟動介面 Visual Studio 啟動 UI

  • 點選"建立新項目"按鈕。
  • 從專案範本中選擇"C# 控制台應用程式",然後按一下"下一步"按鈕。 您可以根據自己的需求選擇平台。

如何使用 C# 在 PDF 中新增圖像,圖 2:在 Visual Studio 中建立控制台應用程式 在 Visual Studio 中建立控制台應用程式

接下來,為你的專案命名,然後點擊"下一步"按鈕。

  • 選擇目標 .NET Framework >= .NET Core 3.1 版本,然後按一下"建立"按鈕。

按照上述步驟,您就可以輕鬆建立一個新的 C# 專案。 您可以使用現有的 C# 項目。 只需打開項目並安裝 IronPDF 庫即可。

安裝 IronPdf 函式庫

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

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

使用 NuGet 套件管理器

若要使用 NuGet 套件管理器安裝該庫,請依照下列步驟操作:

  • 從主選單選項中選擇"工具" > "NuGet 套件管理員" > "管理解決方案的 NuGet 套件"

如何使用 C# 在 PDF 中新增影像,圖 3:導覽至 NuGet 套件管理器 導覽至 NuGet 套件管理器

這將開啟 NuGet 套件管理器視窗。 前往瀏覽選項卡並蒐索 IronPDF。 選擇 IronPDF 庫,然後按一下"安裝"按鈕。

圖 4:如何使用 C# 在 PDF 中新增映像:從 NuGet 套件管理器安裝 IronPdf 套件 從 NuGet 套件管理器安裝 IronPdf 套件

使用軟體套件管理器控制台

以下是使用控制台安裝 IronPDF 庫的步驟。

  • 開啟程式套件管理員控制台(通常位於 Visual Studio 的底部)。
  • 輸入以下指令開始安裝 IronPDF 庫。
Install-Package IronPdf

它將開始安裝,您將能夠看到安裝進度。 安裝完成後,您就可以很快地在專案中使用 IronPDF 庫。

如何使用 C# 在 PDF 中新增圖像,圖 5:


庫已經安裝完畢,現在是時候編寫程式碼將圖像添加到 PDF 文件中了。 首先導入 IronPDF 命名空間。 所以,請在你的程式碼檔案中寫入以下這行程式碼:

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel

在 PDF 文件中新增點陣圖和影像

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

我們來看一下:

using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}
using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}
Imports IronPdf
Imports System.IO
Imports System.Drawing

Friend Class PDFImageAdder
	' This method demonstrates how to convert an image file to a PDF document in C# 
	Shared Sub Main(ByVal args() As String)
		' Initialize IronPdf Renderer
		Dim renderer = New IronPdf.ChromePdfRenderer()

		' Read the PNG image file into binary format
		Dim pngBinaryData = File.ReadAllBytes("embed_me.png")

		' Convert image binary data to base64 for embedding in HTML
		Dim ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

		' Embed the image as a base64 data URI in an HTML <img> tag
		Dim ImgHtml = $"<img src='{ImgDataURI}'>"

		' Render the HTML as a PDF document
		Dim pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml)

		' Save the rendered PDF document
		pdfdoc.SaveAs("embedded_example_1.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

該程式首先會載入圖像。上述程式碼中的ReadAllBytes函數會將影像轉換為位元組格式。 之後,圖像資料將被編碼為 base64 格式並放入 HTML 檔案中。<img>標籤以字串形式呈現。 之後,將使用RenderHtmlAsPdf方法函數將 HTML 字串渲染成 PDF。 它會在 PDF 文件中建立一個 PDF 頁面。

下一個範例將展示如何在 PDF 文件中使用點陣圖影像。 IronPDF 提供了一種將System.Drawing.Image嵌入到 HTML 文件中的實用方法,然後可以渲染為 PDF。 請造訪以下ImageUtilities API以了解更多資訊。 以下程式碼將展示其工作原理:

using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}
using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}
Imports IronPdf
Imports System.Drawing

Friend Class PDFImageAdder
	Shared Sub Main(ByVal args() As String)
		' Initialize IronPdf Renderer
		Dim renderer = New IronPdf.ChromePdfRenderer()

		' Create a Bitmap image
		Dim MyImage As New Bitmap("Path-to-Your-Image")

		' Convert the Bitmap image to a Data URI
		Dim DataURI As String = IronPdf.Util.ImageToDataUri(MyImage)

		' Embed the image as a Data URI in an HTML <img> tag
		Dim ImgHtml = $"<img src='{DataURI}'>"

		' Render the HTML to PDF
		Dim pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml)

		' Save the PDF document
		pdfdoc2.SaveAs("embedded_example_2.pdf")
	End Sub
End Class
$vbLabelText   $csharpLabel

在上面的程式碼中, ImageToDataUri函數用於將影像轉換為 URI 格式。 然後使用RenderHtmlAsPdf函數將影像繪製到 PDF 文件中。 這適用於多張圖片。

此外,IronPDF 還能夠在 PDF 中渲染圖表為 PDF 文件添加條碼,使用密碼和浮水印增強 PDF 安全性,甚至以程式設計方式處理 PDF 表單

授權

IronPDF 是一個優秀的 PDF 庫,可以幫助您建立和自訂 PDF 文件,現在即可購買。 但是,IronPDF 完全免費,可用於開發目的。 您也可以啟動免費試用版用於生產環境,無需提供任何付款資訊。 購買 IronPDF 後,Iron Software 將為您提供超值優惠,只需支付兩套 Iron Software 軟體包的價格即可購買五套 Iron Software 軟體包。 是的! 你沒聽錯——現在只需兩款產品的價格,即可購買一套五款 Iron Software 產品。 現在購買! 請造訪IronPDF 許可頁面以了解更多詳情。

常見問題解答

如何使用 C# 在 PDF 中加入圖片?

您可以使用 C# 將圖片轉換為 base64 格式,嵌入 HTML  related to 如何使用 C# 在 PDF 中加入圖片? 標籤中,並使用 IronPDF 的 RenderHtmlAsPdf 方法將 HTML 轉換為 PDF,從而在 PDF 中加入圖片。

建立 C# 專案將影像加入 PDF 的步驟為何?

若要建立一個 C# 專案來新增圖片至 PDF,請開啟 Visual Studio,建立一個新的 C# Console Application,並確保您的專案以 .NET Framework 3.1 或更高版本為目標。透過 NuGet Package Manager 或 Package Manager Console 安裝 IronPDF 函式庫。

如何在 C# 中將影像轉換為 base64 以嵌入 PDF?

在 C# 中,您可以將影像轉換為 base64,方法是將影像檔案讀入位元組陣列,然後再使用 Convert.ToBase64String 進行轉換。此 base64 字串可嵌入 HTML  related to 如何在 C# 中將影像轉換為 base64 以嵌入 PDF? 標籤中,以便使用 IronPDF 進行 PDF 轉換。

支援哪些影像格式以嵌入 PDF?

IronPDF 支援多種圖像格式,讓您可以在 PDF 文件中嵌入各種類型的圖像,包括 JPEG、PNG 和 BMP。

使用 C# 在 PDF 中嵌入位圖影像的方法是什麼?

要使用 C# 在 PDF 中嵌入 Bitmap 圖片,請使用 ImageToDataUri 函式將 Bitmap 轉換為 Data URI,將其嵌入 HTML  related to 使用 C# 在 PDF 中嵌入位圖影像的方法是什麼? 標籤中,並使用 IronPDF 的 RenderHtmlAsPdf 方法將其渲染為 PDF。

如何在嵌入圖片的同時增強 PDF 的安全性?

IronPDF 提供增強 PDF 安全性的功能,例如新增密碼和權限。透過在 PDF 建立過程中設定安全選項,可同時嵌入圖片。

我可以將圖表和 BarCode 與影像一併加入 PDF 嗎?

是的,除了圖像之外,IronPDF 還允許您在 PDF 中添加圖表和 BarCode。這些元素可以使用 HTML 和 CSS 來建立和渲染,然後再使用 IronPDF 轉換成 PDF。

IronPDF 有哪些授權選項?

IronPDF 為開發人員提供免費試用,並為更廣泛的使用提供具有成本效益的授權選項。更多資訊請參閱 IronPdf 授權頁面。

如何使用套件管理員控制台安裝 IronPdf?

若要使用套件管理員控制台安裝 IronPDF,請使用 Install-Package IronPdf 指令。

IronPDF 是否與 .NET 10 相容?

是 - IronPDF 與 .NET 10 完全相容,同時也與早期版本相容,包括 .NET 9、8、7、6、.NET Core、.NET Standard 和 .NET Framework。

Curtis Chau
技術作家

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

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