如何在 C# 中將圖片轉換為 PDF

如何在 C# 中將圖片轉換為 PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 讓 C# 開發人員能夠透過 ImageToPdfConverter.ImageToPdf 方法,將單張或多張圖片(JPG、PNG、TIFF)轉換為 PDF 文件,並可自訂圖片的排列方式與渲染選項。

將圖片轉換為 PDF 是指將多個圖片檔案(例如 JPG、PNG 或 TIFF)合併為單一 PDF 文件。 此流程可建立數位作品集、簡報或報告,讓您能以有條理且通用的可讀格式,更輕鬆地分享與儲存圖片集合。

IronPDF 可將單張或多張圖片轉換為 PDF 檔案,並賦予圖片獨特的排版位置與行為。 這些行為包括:調整至頁面大小、在頁面中央對齊,以及裁切頁面。 此外,您可透過 IronPDF 加入文字及 HTML 頁首與頁尾套用浮水印、設定自訂頁面尺寸,並加入背景與前景疊加層。

快速入門:使用 IronPDF 將圖片轉換為 PDF using IronPDF 的 ImageToPdfConverter 類別將圖片轉換為 PDF 文件。 此範例展示如何將圖像檔案轉換為 PDF,讓您能將圖像轉 PDF 功能整合至您的 .NET C# 應用程式中。 只需少量程式碼,即可將圖片轉換為 PDF,用於製作數位作品集或報告。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 請複製並執行此程式碼片段。

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. 部署至您的生產環境進行測試

    立即透過免費試用,在您的專案中開始使用 IronPDF

    arrow pointer


如何將單張圖片轉換為 PDF?

請使用 靜態方法,該方法位於 類別中,用於將圖片轉換為 PDF 文件。 此方法僅需圖片的檔案路徑,即可將其轉換為 PDF 文件,並採用預設的圖片定位與行為。 支援的圖像格式包括 .bmp、.jpeg、.jpg、.gif、.png、.svg、.tif、.tiff、.webp、.apng、.avif、.cur、.dib、.ico、.jfif、.jif、.jpe、.pjp 及 .pjpeg。

開始之前,請確認您已透過 NuGet 安裝 IronPDF,或已下載 Windows 安裝程式。 此函式庫可在 WindowsmacOSLinux 平台間無縫運作,使其能靈活適用於各種開發環境。

支援哪些圖像格式?

Iron Software 團隊成員身著紫色制服出席公司活動

IronPDF 支援廣泛的圖像格式,包括 JPEG、PNG、BMP 和 GIF 等點陣格式,以及 SVG 圖形等向量格式。 此函式庫同時支援標準格式與 WebP、AVIF 等現代格式,確保與當代網路應用程式的相容性。 針對特殊需求,請配合使用圖示檔案 (.ico) 和游標檔案 (.cur)。

我該如何撰寫程式碼?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

若需處理更複雜的場景,可探索異步 PDF 生成技術,以提升處理多張圖片時的效能。 此函式庫亦支援自訂紙張尺寸邊距設定,確保您的圖片能精準呈現所需效果。

翻譯成果應呈現何種樣貌?


如何將多張圖片轉換為 PDF?

若要將多張圖片轉換為 PDF 文件,請提供一個包含多個檔案路徑的 `` 物件,而非單一檔案路徑。 這會產生一份 PDF 文件,其中包含預設的圖片位置與行為。

處理多張圖片時,請考慮利用 PDF 壓縮選項,在不犧牲畫質的前提下優化檔案大小。 這在製作大型作品集或相片集時尤為重要。

如何一次處理多張圖片?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")
$vbLabelText   $csharpLabel

多圖像 PDF 的樣貌為何?


如何控制圖片的排列位置與行為?

IronPDF 提供多種圖片定位與行為設定選項。 您可以將圖片置中於頁面,或使其符合頁面大小並維持原始長寬比。 所有可用的圖片位置與行為如下:

  • : 圖片置於頁面的左上角。
  • : 圖片置於頁面的右上角。
  • : 圖片置於頁面中央。
  • : 圖片會適應頁面大小,同時保持原始長寬比。
  • : 圖片置於頁面的左下角。
  • : 圖片置於頁面的右下角。
  • : 圖片適應頁面大小。
  • : 頁面已調整以適應圖片大小。

這些放置選項可與 IronPDF 的頁面方向與旋轉功能無縫整合,讓您無論使用何種圖片尺寸,都能製作出專業外觀的文件。

如何在程式碼中套用圖片行為?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs
using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

圖像行為之間的視覺差異為何?

Iron Software 團隊成員身著紫色品牌運動服,於公司團隊活動中
Iron Software 團隊成員身著紫色品牌運動服,出席戶外活動
Iron Software 團隊成員身著紫色品牌運動服,於公司團隊活動中
身穿紫色制服的 Iron Software 團隊成員於公司體育活動中
Iron Software 團隊成員身著紫色運動服裝,於公司體育活動中合影,畫面疊加
Iron Software 團隊成員身著紫色品牌運動服,於公司體育活動中亮相,畫面疊加品牌文字
身穿紫色制服的 Iron Software 團隊成員於公司團隊活動中,畫面疊加
Iron Software 團隊成員身著紫色品牌運動服,於公司團隊活動中

如何自訂 PDF 渲染選項?

靜態方法透過將圖片匯入為 HTML 標籤,並將 HTML 轉換為 PDF。 這讓您可以將 `` 物件作為第三個參數傳入,以直接自訂渲染流程。

此方法可存取 IronPDF 提供的所有強大渲染選項,包括 JavaScript 執行、CSS 媒體類型及視口設定。 您甚至可以加入網頁字型和圖示,以提升文件的視覺吸引力。

如何新增標題與自訂樣式?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
$vbLabelText   $csharpLabel

若需處理更複雜的頁首與頁尾設定,請參閱我們關於 HTML 頁首與頁尾的完整指南。 您亦可為圖像型 PDF 檔案添加頁碼,以利文件管理。

客製化輸出內容會是什麼樣子?

如何處理效能與大型圖片集合?

處理大量圖片集合或高解析度圖片時,請採用非同步與多執行緒技術以提升效能。 針對 Enterprise 級應用程式,請參考 IronPDF 的效能優化策略,以確保即使在高負載情況下仍能順暢運作。

此外,若需處理儲存於雲端服務中的圖片,請參閱我們關於從 Azure Blob Storage 嵌入圖片的指南,以實現無縫的雲端整合。

如何將 PDF 轉換回圖片?

若要將 PDF 文件轉換或柵格化為圖片,請參閱我們的《如何將 PDF 柵格化為圖片》指南

準備好探索更多可能性了嗎? 請點此查看我們的教學頁面:PDF 轉換

常見問題

哪些圖像格式可以轉換為 PDF?

IronPDF 支援廣泛的圖像格式進行 PDF 轉換,包括 .bmp、.jpeg、.jpg、.gif、.png、.svg、.tif、.tiff、.webp、.apng、.avif、.cur、.dib、.ico、.jfif、.jif、.jpe、.pjp 及 .pjpeg。 這既包含 JPEG、PNG、BMP 和 GIF 等點陣格式,也涵蓋 SVG 圖形等向量格式。

如何在 C# 中將單張圖片轉換為 PDF?

若要使用 IronPDF 將單張圖片轉換為 PDF,請使用 ImageToPdfConverter 類別中的 ImageToPdf 靜態方法。只需提供圖片的檔案路徑即可:IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf")。這行代碼即可將圖片轉換為 PDF 文件,並採用預設的版面配置與行為。

我可以將多張圖片合併成單一 PDF 文件嗎?

是的,IronPDF 允許您透過 ImageToPdfConverter.ImageToPdf 方法,將多張圖片(JPG、PNG、TIFF)轉換為單一 PDF 文件。此功能非常適合製作數位作品集、簡報或報告,當您需要將多個圖片檔案整合為一個組織完善、通用的 PDF 格式時,此功能能完美滿足需求。

將圖片轉換為 PDF/A 時有哪些自訂選項?

IronPDF 提供廣泛的自訂選項,包括獨特的圖片定位與行為(適應頁面、居中、裁切)、新增文字及 HTML 頁首與頁尾、套用浮水印、設定自訂頁面尺寸,以及加入背景與前景疊加層。這些功能讓您能夠從圖片中建立出專業外觀的 PDF 文件。

圖片轉 PDF 功能支援哪些平台?

IronPDF 的圖片轉 PDF 功能可在 Windows、macOS 和 Linux 平台上無縫運作,使其能靈活適應各種開發環境。您可以透過 NuGet 安裝,或下載 Windows 安裝程式,在您偏好的平台上開始使用。

轉換為 PDF 時,如何控制圖片的排列位置?

IronPDF 提供獨特的圖片定位與行為設定,包括適應頁面、居中對齊及裁切頁面。這些圖片匯出行為讓您能精確控制圖片在最終 PDF 文件中的呈現方式,確保視覺內容展現出專業水準。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

審閱者:
Jeff Fritz
Jeffrey T. Fritz
首席程式經理 - .NET 社群團隊
Jeff 同時也是 .NET 與 Visual Studio 團隊的首席程式經理。他是 .NET Conf 虛擬會議系列的執行製作人,並主持每週播出兩次的開發者直播節目《Fritz and Friends》,在節目中他會與觀眾一起探討技術話題並共同編寫程式碼。Jeff 負責撰寫工作坊內容、準備簡報,並為 Microsoft Build、Microsoft Ignite、.NET Conf 以及 Microsoft MVP Summit 等微軟最大規模的開發者活動規劃內容。
準備開始了嗎?
Nuget 下載 18,926,724 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。