将 JPEG 转换为 PDF .NET | IronPDF for .NET C# 教程

如何安装 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 页面大小调整为与图像尺寸相匹配。 如果您需要不同的行为——将图像调整为标准纸张大小、用白色边距居中或裁剪以填充页面——请使用 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，这些模板将文本和图像组合在一个文档中。