如何使用 C# 將圖像轉換為 PDF

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

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

將圖像轉換為 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 範例

使用ImageToPdfConverter類別中的ImageToPdf靜態方法將影像轉換為 PDF 文件。 此方法只需要影像的檔案路徑,即可轉換為具有預設影像位置和行為的 PDF 文件。 支援的圖片格式包括 .bmp、.jpeg、.jpg、.gif、.png、.svg、.tif、.tiff、.webp、.apng、.avif、.cur、.dib、.ico、.jfif、.jif、.jpe、.pjp 和 .pjpeg。

範例影像

圖片範例

程式碼

: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 文件。

: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


圖片放置和行為

為了方便使用,我們提供了一系列有用的圖像放置和行為選項。 例如,您可以將圖像居中顯示在頁面上,或使其適應頁面大小,同時保持其寬高比。 所有可用的影像放置位置和行為如下:

  • 頁面左上角:圖片放置在頁面的左上角。
  • 頁面右上角:圖片放置在頁面的右上角。
  • 居中於頁面:圖像在頁面上居中顯示。
  • 適應頁面並保持寬高比:圖片適應頁面,同時保持其原始寬高比。
  • 頁面左下角:圖像位於頁面的左下角。
  • 頁面右下角:圖像放置在頁面的右下角。
  • 適應頁面:圖片適應頁面大小。 -裁剪頁面:調整頁面以適應影像。
: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

影像行為比較

將圖片放置在頁面左上角。
將圖片放置在頁面右上角。
將圖片放在頁面中央。
在保持寬高比的前提下,使圖像適應頁面。
將圖片放置在頁面左下角。
將圖片放置在頁面右下角。
拉伸圖像以適應頁面
裁剪頁面以適應圖片。

應用程式渲染選項

ImageToPdf靜態方法將各種類型的圖像轉換為 PDF 文件的關鍵在於,它首先將圖像作為 HTML 匯入。<img>然後將 HTML 轉換為 PDF。 這也是為什麼我們可以將ChromePdfRenderOptions物件作為ImageToPdf方法的第三個參數傳遞,以便直接自訂渲染過程。

: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

輸出 PDF

如果您想將 PDF 文件轉換為圖像,請參閱我們的PDF 轉圖像柵格化指南

準備好看看您還能做些什麼嗎? 請造訪我們的教學頁面:轉換 PDF 文件

常見問題解答

.NET C# 中如何將圖像轉換為 PDF?

通過使用 IronPDF 庫的 ImageToPdfConverter 類,您可以在 .NET C# 中將圖像轉換為 PDF。該類提供了一種簡單的方法,只需指定圖像路徑即可將圖像文件轉換為 PDF 文檔。

.NET C# 中使用哪些圖像格式可轉換為 PDF?

使用 IronPDF,您可以將多種圖像格式轉換為 PDF,包括 BMP、JPEG、GIF、PNG、SVG、TIFF、WEBP 等。這種靈活性確保與大多數圖像文件的兼容性。

如何在 C# 中將多個圖像轉換為一個 PDF 文檔?

要使用 IronPDF 將多個圖像轉換為一個 PDF 文檔,您可以提供包含圖像文件路徑的 IEnumerable 對象。這使您可以將所有圖像匯編成一個連貫的 PDF 文件。

PDF 中圖像放置有什麼選項?

IronPDF 為 PDF 中的圖像提供多種放置選項,例如 TopLeftCornerOfPage、CenteredOnPage、FitToPageAndMaintainAspectRatio 等。這些選項允許您自訂圖像在 PDF 頁面上的顯示方式。

在將圖像轉換時,可以在 PDF 中添加標頭和頁尾嗎?

是的,使用 IronPDF 可以在將圖像轉換時向 PDF 添加自訂文本和 HTML 標頭與頁尾。此功能對於在 PDF 文檔中添加額外信息或品牌化非常有用。

在圖像轉換時,是否可以在 PDF 中添加浮水印?

是的,在轉換過程中,IronPDF 允許您將浮水印應用於 PDF。您可以按照 IronPDF 的 tutorials 中的指南來添加浮水印。

如何自訂圖像到 PDF 的轉換過程?

在 IronPDF 中,您可以通過使用 ChromePdfRenderOptions 對象來自訂圖像到 PDF 的轉換過程。這允許您調整渲染設定以滿足您的特定需求。

IronPDF 使用什麼方法將圖像轉換為 PDF?

IronPDF 通過將圖像作為 HTML <img> 標籤導入並將其渲染為 PDF 格式來將圖像轉換為 PDF。這種方法在自訂輸出文件方面提供了靈活性。

我可以在哪裡找到更多有關使用 IronPDF 將圖像轉換為 PDF 的資源?

更多有關使用 IronPDF 將圖像轉換為 PDF 的資源和教程可以在 IronPDF 官方網站及其全面的文件中找到。

將圖像轉換為 PDF 如何對數字項目有益?

將圖像轉換為 PDF 有助於通過將多個圖像組織成單一且可共享的文檔來提高數字項目的效率。這對於創建需要以通用可讀格式分發的數字作品集、演示文稿或報告非常理想。

IronPDF 將影像轉換為 PDF 時是否與 .NET 10 完全相容?

是的,IronPDF 完全相容於 .NET 10。該程式庫官方支援 .NET 10(以及 .NET 9、8、7、6 和 Core 版本),無需任何變通或配置即可實現影像到 PDF 的轉換、HTML 渲染以及所有關鍵功能。 ([ironpdf.com](https://ironpdf.com/?utm_source=openai))

Curtis Chau
技術作家

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

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

審核人
Jeff Fritz
Jeffrey T. Fritz
首席程序经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席程序经理。他是 .NET Conf 虚拟会议系列的执行制作人,并主持“Fritz 和朋友”这一每周两次的开发者的直播节目,在节目上讨论技术并与观众一起编写代码。Jeff 撰写研讨会、主持演讲,并计划大型 Microsoft 开发者活动(包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP Summit)的内容。
準備好開始了嗎?
Nuget 下載 16,493,056 | Version: 2025.11 剛發表