如何使用 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 應用浮水印,設定自訂頁面大小,以及新增背景和前景疊加層。

快速入門:使用 IronPDF 將影像轉換為 PDF

使用 IronPDF 的 ImageToPdfConverter 類將影像轉換成 PDF 文件。 本範例示範如何將影像檔案轉換成 PDF,讓您可以將影像轉 PDF 功能整合到您的 .NET C# 應用程式中。 使用最少的程式碼,您就可以將影像轉換成 PDF,以建立數位作品集或報告。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

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

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


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

使用 ImageToPdf 類中的 ImageToPdfConverter 靜態方法將影像轉換為 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 平台上無縫運作,因此適用於各種開發環境。

支援哪些圖片格式?

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

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 文件,請提供一個包含檔案路徑的 IEnumerable物件,而非單一的檔案路徑。 這會產生一個具有預設圖片位置和行為的 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 提供各種圖片位置與行為選項。 您可以將圖片置於頁面中央,或使其符合頁面大小,同時保持長寬比。 所有可用的圖片位置和行為都是:

  • TopLeftCornerOfPage圖片放置在頁面的左上角。
  • TopRightCornerOfPage圖片放置在頁面的右上角。
  • CenteredOnPage:圖片在頁面上居中。
  • FitToPageAndMaintainAspectRatio圖片適合頁面,同時保持其原始寬高比。
  • BottomLeftCornerOfPage圖片放置在頁面的左下角。
  • BottomRightCornerOfPage圖片放置在頁面的右下角。
  • FitToPage: 圖片適合頁面。
  • CropPage頁面調整以符合圖片。

這些放置選項可與 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 團隊成員穿著紫色品牌運動服參加公司團隊活動
IronSoftware 團隊成員穿著紫色制服參加公司運動會
Iron Software 團隊成員穿著紫色運動裝備出席公司運動會,並覆蓋
Iron Software 團隊成員穿著紫色品牌運動服參加公司運動會,並覆蓋品牌文字
IronSoftware 團隊成員身著紫色制服參加公司團隊活動,並在
Iron Software 團隊成員穿著紫色品牌運動服參加公司團隊活動

如何自訂 PDF 渲染選項?

ImageToPdf 靜態方法透過匯入圖片為 HTML <img> 標籤,然後將 HTML 轉換為 PDF。 這可讓您傳送 ChromePdfRenderOptions 物件作為第三個參數,以直接自訂呈現程序。

此方法可讓您存取 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,以便更好地組織。

自訂輸出是什麼樣子?

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

在處理大型圖片集或高解析度圖片時,實施 async 和多執行緒技術以提高效能。 針對企業應用程式,探索 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 時,有哪些自訂選項?

IronPDF 提供廣泛的客製化選項,包括獨特的圖片位置和行為(貼合頁面、居中、裁剪)、新增文字和 HTML 標頭與頁腳、套用水印、設定自訂頁面大小,以及包含背景和前景覆蓋。這些功能可讓您利用影像製作專業級的 PDF 文件。

影像轉換為 PDF 的功能支援哪些平台?

IronPdf 的圖像轉換為 PDF 可在 Windows、macOS 和 Linux 平台上無縫運作,因此適用於各種開發環境。您可以透過 NuGet 安裝,或下載 Windows 安裝程式,在您偏好的平台上開始使用。

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

IronPDF 提供了獨特的圖像放置和行為,包括貼合頁面、在頁面上居中以及裁剪頁面。這些匯出圖片行為可讓您精確控制圖片在最終 PDF 文件中的顯示方式,確保專業呈現您的視覺內容。

Curtis Chau
技術撰稿人

Curtis Chau 擁有電腦科學學士學位(卡爾頓大學),專長於前端開發,精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情,他喜歡使用現代化的架構,並製作結構良好且視覺上吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 也有濃厚的興趣,他喜歡探索整合硬體與軟體的創新方式。在空閒時間,他喜歡玩遊戲和建立 Discord bots,將他對技術的熱愛與創意結合。

審核人
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 等大型 Microsoft 開發人員活動撰寫工作坊、簡報和規劃內容。
準備好開始了嗎?
Nuget 下載 17,386,124 | 版本: 2026.2 剛剛發布