IRONSOFTWAREHOME
使用IRONPDF

C# Convert PNG to PDF (Code Example Tutorial)

Curtis Chau
Curtis Chau
Updated: 2026年4月21日

從開發人員的角度來看,程式化地將圖像新增到PDF文件是一項具有挑戰性的任務,因為圖像格式多樣且操作起來較為複雜。 因此,推薦使用IronPDF C#程式庫程式化地將圖像新增到PDF文件。 來探索一下什麼是IronPDF以及如何有效地使用它。

IronPDF: C# PDF Library

IronPDF C#程式庫是一個用C#編寫的PDF程式庫,以PDF的物件模型為目標。 這個程式庫為開發人員提供了一種建立、編輯和保存PDF文件的方法,無需緊密維護與特定API(如Adobe的Acrobat)的相關性。 當您不想使用Adobe Acrobat或其他軟體時,可以使用IronPDF 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啟動介面

  • 點擊 "建立一個新專案" 按鈕。
  • 從專案範本中選擇 "C# 控制台應用程式",然後點擊 下一步 按鈕。 您可以根據需要選擇平臺。

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

  • 接下來,給您的專案命名,然後點擊 下一步 按鈕。
  • 選擇目標.NET框架 >= .NET Core 3.1版本,然後點擊 建立 按鈕。

通過遵循上述步驟,您將能夠輕鬆建立一個新的C#專案。 您可以使用已經存在的C#專案。 只需打開專案並安裝IronPDF程式庫。

安裝IronPDF程式庫

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

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

使用NuGet套件管理器

要使用NuGet套件管理器安裝程式庫,請按照以下步驟操作:

  • 從主選單選項中選擇 工具 > NuGet套件管理器 > 管理方案的NuGet套件。

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

  • 這將打開NuGet套件管理器窗口。 轉到瀏覽選項卡並搜索IronPDF。 選擇IronPDF程式庫並點擊 "安裝" 按鈕。

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

使用套件管理器控制台

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

  • 前往套件管理器控制台(通常位於Visual Studio的底部)。
  • 寫下以下命令開始安裝IronPDF程式庫。

PM > Install-Package IronPdf

這將開始安裝,您將能夠看到安裝的進度。 安裝完成後,您將能夠非常快速地在專案中使用IronPDF程式庫。

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


程式庫已安裝,現在是時候編寫將圖像新增到PDF文件的程式碼了。 開始時導入IronPDF命名空間。 因此,請在您的程式碼文件中寫下以下行:

using IronPdf;

將位圖和圖像新增到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");
    }
}

這個程式首先會載入圖像。在上面的程式碼中ReadAllBytes函式將圖像轉換為字節格式。 然後,圖像資料將被編碼為base64格式並作為字串放入HTML的<img>標籤中。 然後,HTML字串將通過RenderHtmlAsPdf方法函式渲染為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");
    }
}

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

此外,IronPDF還能夠在PDF中渲染圖表,向PDF文件中新增條碼,通過密碼增強PDF安全性及為PDF文件新增水印,甚至程式化地處理PDF表單。

授權

IronPDF是一個出色的PDF程式庫,幫助您建立和自訂PDF文件,如今可以購買。 然而,IronPDF對於開發用途是完全免費的。 您也可以啟用免費試用版本用於生產而不需要任何付款資訊。 購買IronPDF後,Iron Software為您提供了一個奇妙的優惠:以只需兩個的價格購買五個Iron Software套件。 沒錯! 您聽的沒錯——只需兩個的價格便可購買五個Iron Software產品的組合包。 現在就購買! 存取IronPDF授權頁面了解更多詳情。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

相關文章

Key in blue circle

立即免費取得 30 天試用金鑰。

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

OR
bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
預訂您的免費現場演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密。
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立
C# 用於PDF的NuGet程式庫
使用NuGet安裝

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器,右鍵點選參考,管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝
C# PDF DLL
下載DLL

版本: 2026.9

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置,位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器,右鍵點選參考。選擇瀏覽,"IronPdf.dll"

授權從$999起