IronPDF：在 C# 中對齊 W3C 的可存取 HTML 轉換為 PDF

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

在編寫任何轉換程式碼之前，將IronPDF新增到您的.NET專案中。 該程式庫通過NuGet分發，安裝僅需幾秒鐘。

在Visual Studio中打開Package Manager Console，然後運行：

Install-Package IronPdf

或者使用.NET CLI：

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中的順序與它們在列舉中的順序相同。 要控制頁面順序，在將文件路徑傳遞給轉換器之前進行排序——例如，按文件名、建立日期或任何適合您工作流程的自定義順序。

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，BMP，GIF，TIFF，SVG和WebP文件——您不需要為不同的圖像型別單獨編寫程式碼路徑。

對於TIFF文件，IronPDF專門支持多幀TIFF到PDF轉換，其中TIFF中的每一幀在輸出PDF中變為單獨的頁面。 這對於作為TIFF存檔到達的掃描多頁文件特別有用。

除了靜態光柵圖像，IronPDF還以全解析度處理SVG向量圖形，使其成為沒有質量損失地轉換技術圖和圖標的可靠工具。 處理圖像的引擎也渲染HTML到PDF，因此含有圖像和HTML格式文字的混合內容管道得到了良好的支持。

與基於瀏覽器或在線PDF轉換器不同，IronPDF完全在您的.NET進程內運行。 文件從不離開您的伺服器，這對於處理機密文件、醫學圖像或財務紀錄的應用來說很重要。

如何控制轉換後PDF中的圖像放置？

預設情況下，IronPDF將PDF頁面尺寸調整為與圖像尺寸匹配。 如果您需要不同的行為——將圖像適配到標準紙張尺寸，在白色邊界內居中或裁剪以填充頁面——使用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文件到專業PDF文件在C#中的一條簡單路徑。 該API處理單個圖像和批量集合使用相同的方法調用，支持七種圖像格式而無需額外編碼，並與IronPDF的全套PDF操作功能整合。

首先通過NuGet安裝包：

Install-Package IronPdf

然後將本教程中的程式碼範例適應為您的用例。 單圖像轉換只需三行程式碼即可實現。 批量處理需要一個LINQ查詢和一個方法調用。 佈局自定義使用ImageBehavior枚舉。

IronPDF免費試用讓您完全存取所有功能進行評估。 當您準備好用於生產時，查看商業應用的授權選項，包括擴展團隊的授權升級路徑。 IronPDF PDF 轉換器功能頁面列出了每一種支持的轉換型別，以便您在需要處理的不僅僅是JPEG輸入時使用。

對於相關的圖像到文件工作流程，新增圖像到PDF指南涵蓋嵌入圖像到現有PDF頁面中的方法，HTML到PDF教程則說明如何從HTML模板生成PDF，將文字和圖像結合進行單一文件。