Convert JPEG to PDF .NET | IronPDF for .NET C# Tutorial

如何安裝 IronPDF 以進行 JPEG 轉 PDF 轉換？

在編寫任何轉換程式碼之前，請將 IronPDF 新增至您的 .NET 專案。 該庫透過 NuGet 分發，只需幾秒鐘即可安裝完成。

在 Visual Studio 中開啟套件管理員控制台並執行：

Install-Package IronPdf

Install-Package IronPdf

或使用 .NET CLI：

dotnet add package IronPdf

dotnet add package IronPdf

IronPDF 的目標平台為 .NET 8、.NET 9 和 .NET 10，以及 .NET Framework 4.6.2 及更高版本。 無需額外的執行時間依賴項——該軟體包包含在 Windows、Linux、macOS、Docker 和 Azure 上將映像轉換為 PDF 所需的一切。

安裝完成後，在檔案頂部新增一條 using IronPdf; 語句，即可開始轉換。

IronPDF NuGet 套件捆綁了渲染引擎，因此生產伺服器無需單獨的安裝程式。 對於雲端部署，請查閱Docker 設定指南以配置正確的基礎映像。

如何在 C# 中將單一 JPEG 影像轉換為 PDF？

將 JPEG 轉換為 PDF 最簡單的方法是使用 ImageToPdfConverter.ImageToPdf() 靜態方法。 傳遞圖像檔案路徑，接收一個 PdfDocument 對象，並將其儲存到您需要的任何位置。

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

using IronPdf;

// Convert a single JPG image to PDF
string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Save the converted PDF file
pdf.SaveAs("converted-photo.pdf");

Imports IronPdf

' Convert a single JPG image to PDF
Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Save the converted PDF file
pdf.SaveAs("converted-photo.pdf")

ImageToPdf 方法接受 JPEG 檔案的檔案路徑，並傳回一個PdfDocument對象，您可以儲存、串流或將其傳遞給其他 IronPDF 操作。 轉換過程在記憶體中進行，因此非常適合需要直接提供 PDF 檔案而無需存取磁碟的Web 應用程式。

輸出的 PDF 檔案在保持原始影像品質的同時，將其打包成任何 PDF 閱讀器都能打開的格式。 頁面尺寸會自動處理－PDF 頁面尺寸預設與影像尺寸相符，因此除非您提出要求，否則輸出結果將乾淨整潔，沒有白邊。 如果需要特定的邊距，請使用自訂邊距 API 。

對於已經熟悉HTML 轉 PDF 轉換的開發人員來說，影像轉換 API 遵循相同的模式：提供輸入，根據需要設定選項，然後儲存輸出。

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

using IronPdf;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Get the PDF as a byte array for streaming
byte[] pdfBytes = pdf.BinaryData;

// In an ASP.NET Core controller:
// return File(pdfBytes, "application/pdf", "converted.pdf");

Imports IronPdf

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Get the PDF as a byte array for streaming
Dim pdfBytes As Byte() = pdf.BinaryData

' In an ASP.NET Core controller:
' Return File(pdfBytes, "application/pdf", "converted.pdf")

如何將多個JPEG文件合併成一個PDF文件？

批量轉換——將多個 JPEG 影像合併成一個 PDF 檔案——同樣簡單直接。 將檔案路徑枚舉傳遞給 ImageToPdfConverter.ImageToPdf()，該程式庫會將每張圖片放在輸出的單獨頁面上。

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

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

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Gather all JPG files from a folder
var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)
             || f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase));

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

// Save the combined PDF
pdf.SaveAs("photo-collection.pdf");

Imports IronPdf
Imports System.IO
Imports System.Linq

' Gather all JPG files from a folder
Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) _
             OrElse f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase))

' Convert multiple JPEG images to a single PDF file
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Save the combined PDF
pdf.SaveAs("photo-collection.pdf")

影像在 PDF 中的出現順序與它們在枚舉表中出現的順序相同。 要控制頁面順序，請在將檔案路徑傳遞給轉換器之前對其進行排序——例如，按檔案名稱、建立日期或任何適合您工作流程的自訂排序。

！一行顯示七頁文檔，編號為 1-7，顯示各種文字佈局和圖像，看起來像是 PDF 轉換的範例文件。

! PDF 文件檢視器正在顯示一篇包含嵌入式圖片的多頁維基百科文章，圖中以 25% 的縮放比例顯示轉換後輸出的第 1-9 頁。

using IronPdf;
using System.Collections.Generic;
using System.IO;
using System.Linq;

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

using IronPdf;
using System.Collections.Generic;
using System.IO;
using System.Linq;

var imagePaths = Directory.EnumerateFiles("photos")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));

var pdfDocuments = new List<PdfDocument>();

foreach (var imagePath in imagePaths)
{
    var individualPdf = ImageToPdfConverter.ImageToPdf(
        imagePath,
        ImageBehavior.FitToPageAndMaintainAspectRatio
    );
    pdfDocuments.Add(individualPdf);
}

// Merge all individual PDFs into one document
PdfDocument combinedPdf = PdfDocument.Merge(pdfDocuments);
combinedPdf.SaveAs("custom-photo-collection.pdf");

Imports IronPdf
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

Dim imagePaths = Directory.EnumerateFiles("photos") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase))

Dim pdfDocuments As New List(Of PdfDocument)()

For Each imagePath In imagePaths
    Dim individualPdf = ImageToPdfConverter.ImageToPdf( _
        imagePath, _
        ImageBehavior.FitToPageAndMaintainAspectRatio _
    )
    pdfDocuments.Add(individualPdf)
Next

' Merge all individual PDFs into one document
Dim combinedPdf As PdfDocument = PdfDocument.Merge(pdfDocuments)
combinedPdf.SaveAs("custom-photo-collection.pdf")

此PDF轉換器支援哪些影像格式？

IronPDF 的影像轉 PDF 轉換器除了支援 JPEG 格式外，還支援多種其他格式。 同一個 ImageToPdfConverter 類別使用相同的方法呼叫處理 PNG、骨形態發生蛋白、GIF、TIFF、SVG 和 WebP 檔案—您不需要為不同的映像類型單獨編寫程式碼路徑。

具體來說，對於 TIFF 文件，IronPDF 支援多幀 TIFF 到 PDF 的轉換，其中 TIFF 中的每一幀都會成為輸出 PDF 中的單獨頁面。 這對於以 TIFF 格式存檔的掃描多頁文件尤其有用。

除了靜態柵格圖像外，IronPDF 還能以全解析度處理SVG 向量圖形，使其成為轉換技術圖表和圖標而不損失品質的可靠工具。 處理圖像的相同引擎還可以將HTML 渲染成 PDF ，因此混合內容管道（包含圖像和 HTML 格式文字的文檔）得到了很好的支援。

與基於瀏覽器或線上的 PDF 轉換器不同，IronPDF 完全在您的 .NET 進程中執行。 文件永遠不會離開您的伺服器，這對於處理機密文件、醫學影像或財務記錄的應用程式來說至關重要。

如何控制轉換後的 PDF 檔案中影像的位置？

預設情況下，IronPDF 會將 PDF 頁面大小調整為與影像尺寸相符。 如果您需要不同的行為——將圖像調整為標準紙張大小、用白色邊距居中或裁剪以填充頁面——請使用 ImageBehavior 枚舉與 ImageToPdfRenderOptions 結合使用。

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

using IronPdf;

var renderingOptions = new ImageToPdfRenderOptions
{
    ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    PaperSize = PdfPaperSize.A4,
    MarginTop = 25,
    MarginBottom = 25,
    MarginLeft = 25,
    MarginRight = 25
};

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions);
pdf.SaveAs("formatted-output.pdf");

Imports IronPdf

Dim renderingOptions As New ImageToPdfRenderOptions With {
    .ImageBehavior = ImageBehavior.FitToPageAndMaintainAspectRatio,
    .PaperSize = PdfPaperSize.A4,
    .MarginTop = 25,
    .MarginBottom = 25,
    .MarginLeft = 25,
    .MarginRight = 25
}

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, renderingOptions)
pdf.SaveAs("formatted-output.pdf")

可用的 ImageBehavior 值涵蓋了最常見的佈局要求：

• FitToPageAndMaintainAspectRatio -- 縮放影像以填滿頁面，同時保持影像比例
• CenteredOnPage -- 將影像以原始大小放置，水平和垂直居中
• TopLeftCornerOfPage -- 將影像錨定在左上角而不縮放
• CropPage -- 將頁面大小裁切至與圖片尺寸完全匹配

轉換完成後，您也可以套用其他轉換。 使用 HTML 標記新增浮水印，新增頁首和頁尾以識別文檔，或旋轉頁面以符合所需的方向。

其他後製選項包括：

• 用於品牌識別或批准標記的文字或圖像蓋章 -應用背景範本以營造信頭效果 -壓縮輸出的 PDF 文件，以減小文件大小，方便透過電子郵件或上傳。 -繪製形狀和註釋以進行視覺標記

JPEG 轉 PDF 最常見的應用場景有哪些？

程序化JPEG到PDF轉換是許多文件工作流程的基礎組成部分。 了解最常見的場景有助於您為應用程式設計合適的架構。

文件歸檔和合規性－掃描紙本記錄的組織透過平板掃描器和文件掃描器產生 JPEG 文件。 將這些文件轉換為 PDF 格式，可以進行索引、以PDF/A 格式長期存儲，並透過標準文件管理平台進行存取。 PDF/A 是專為歸檔而設計的 ISO 標準，IronPDF 支援產生符合該標準的文件。

報表和儀表板產生－產生圖表、螢幕截圖或資料視覺化的應用程式通常會將輸出擷取為 JPEG 格式。 使用 ImageToPdfConverter 將這些內容嵌入到 PDF 報告中，即可產生一致的、可列印的文檔，利害關係人無需安裝圖表軟體即可查看這些文檔。

照片作品集和圖庫－創意專業人士和房地產平台使用大量 JPEG 轉 PDF 功能來製作可列印的房產清單、作品集和產品目錄 PDF。 將數十張照片合併到一個帶有書籤的可瀏覽 PDF 文件中，比使用圖像文件資料夾呈現效果更好。

自動上傳工作流程——接受使用者上傳的 JPEG 格式照片（個人資料照片、證明文件、身分證掃描件）的 Web 應用程式——可以將所有上傳的文件規範化為 PDF 格式，以便進行一致的下游處理。 這樣就簡化了儲存、搜尋和渲染，因為應用程式只需處理一種格式而不是多種格式。

根據PDF 協會的行業研究，PDF 仍然是企業環境中使用最廣泛的文件格式，因此在工作流程早期將影像轉換為 PDF 格式，在相容性和長期可訪問性方面會帶來豐厚的回報。

Mozilla 開發者網路將PDF MIME 類型記錄為 application/pdf，所有主流瀏覽器都原生支援該類型，無需插件——這使得 PDF 成為需要在瀏覽器中查看的文件最安全的格式選擇。

為了增強上述任何場景下的安全性，IronPDF 支援PDF 編輯以永久刪除敏感內容， PDF 清理以去除隱藏的元數據，以及用於文件認證的數位簽章。

如何為轉換後的 PDF 檔案新增頁首、頁尾和元資料？

將 JPEG 檔案轉換為 PDF 文件通常只是一個起點。 生產應用程式通常需要在交付最終文件之前添加文件元資料、頁碼和組織品牌標識。

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

using IronPdf;
using IronPdf.Editing;

string imagePath = "photo.jpg";
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Add a text footer with page numbers
var footer = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextFooters(footer);

// Set document metadata
pdf.MetaData.Title = "Converted Photo Document";
pdf.MetaData.Author = "Document Processing System";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
);

pdf.SaveAs("final-document.pdf");

Imports IronPdf
Imports IronPdf.Editing

Dim imagePath As String = "photo.jpg"
Dim pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Add a text footer with page numbers
Dim footer As New TextHeaderFooter With {
    .CenterText = "Page {page} of {total-pages}",
    .DrawDividerLine = True,
    .FontSize = 10
}
pdf.AddTextFooters(footer)

' Set document metadata
pdf.MetaData.Title = "Converted Photo Document"
pdf.MetaData.Author = "Document Processing System"
pdf.MetaData.CreationDate = System.DateTime.Now

' Apply a confidentiality watermark if needed
pdf.ApplyWatermark(
    "<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center
)

pdf.SaveAs("final-document.pdf")

對於批次轉換，您可以在儲存之前將相同的頁腳和元資料套用至多影像 PDF 中的每一頁。 非同步處理 API允許高吞吐量環境同時處理多個影像，而不會阻塞線程。

如果您的部署是基於雲端的，請查看Azure 部署指南和AWS 設定文檔，以了解特定於環境的配置。 自訂日誌 API與 Serilog、NLog 和 Microsoft.擴展.Logging 集成，用於運行監控。

IronPDF 故障排除指南涵蓋了生產中最常見的問題，包括字體載入、Linux 上的權限錯誤以及 .NET 版本之間的渲染差異。

下一步計劃是什麼？

IronPDF 的 ImageToPdfConverter 類別為您提供了一條從 JPEG 檔案到 C# 專業 PDF 文件的直接路徑。 該 API 使用相同的方法呼叫處理單一影像和批次集合，無需額外程式碼即可支援七種影像格式，並與 IronPDF 的全部 PDF 操作功能整合。

首先透過 NuGet 安裝該軟體包：

Install-Package IronPdf

Install-Package IronPdf

然後根據你的實際用例，對本教學中的程式碼範例進行調整。 單圖轉換只需三行程式碼即可完成。 批次處理需要一個 LINQ 查詢和一個方法呼叫。 佈局自訂使用 ImageToPdfRenderOptions 類別和 ImageBehavior 枚舉。

IronPDF 免費試用版讓您可以完全存取所有功能進行評估。 準備投入生產時，請查看商業應用程式的授權選項，包括不斷成長的團隊的許可升級途徑。 IronPDF PDF 轉換器具有頁面列表，列出了所有支援的轉換類型，如果您需要處理 JPEG 以外的輸入格式，則該轉換器可以滿足您的需求。

對於相關的圖像到文件工作流程， "向 PDF 添加圖像"指南涵蓋了將圖像嵌入到現有 PDF 頁面中的內容， "HTML 到 PDF"教程解釋瞭如何從 HTML 模板生成 PDF，這些模板將文本和圖像組合在一個文檔中。