如何在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 将图片转换为 PDF using IronPdf 的 ImageToPdfConverter 类将图像转换为 PDF 文档。 本示例演示了如何将图像文件转换为 PDF,使您能够将图像转 PDF 功能集成到 .NET C# 应用程序中。 只需少量代码,即可将图片转换为 PDF,用于制作数字作品集或报告。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 复制并运行这段代码。

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronPDF

    arrow pointer


如何将单张图片转换为 PDF?

using 类中的 静态方法,将图像转换为 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 平台间无缝运行,使其适用于各种开发环境。

支持哪些图像格式?

Iron Software 团队成员身着紫色制服出席公司活动

IronPDF 支持全面的图像格式,包括 JPEG、PNG、BMP 和 GIF 等光栅格式,以及 SVG 图形等矢量格式。 该库同时支持标准格式和 WebP、AVIF 等现代格式,确保与当代 Web 应用程序的兼容性。 针对特殊需求,可处理图标文件(.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 文档,请提供一个包含文件路径的 `` 对象,而非单个文件路径。 这将生成一个具有默认图像位置和行为的 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 提供了多种图像定位和行为选项。 您可以将图片居中显示,或使其适应页面尺寸并保持宽高比。 所有可用的图像位置和行为包括:

  • : 图片位于页面左上角。
  • : 图片位于页面右上角。
  • : 图片居中显示在页面上。
  • : 图片在适应页面大小的同时保持原始宽高比。
  • : 图片位于页面左下角。
  • : 图片位于页面右下角。
  • : 图片适应页面。
  • : 页面已调整以适应图片。

这些布局选项与 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 团队成员身着紫色品牌运动服参加公司团队活动
Iron Software 团队成员身着紫色制服参加公司体育活动
Iron Software 团队成员身着紫色运动服参加公司体育活动,画面上叠加了
Iron Software 团队成员身着紫色品牌运动服参加公司体育活动,画面上叠加了品牌文字
身着紫色制服的 Iron Software 团队成员在公司团队活动上,背景叠加有
Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

如何自定义 PDF 渲染选项?

静态方法通过将图像导入为HTML 标签,随后将 HTML 转换为 PDF。 这允许您将 `` 对象作为第三个参数传递,从而直接自定义渲染过程。

此方法可访问 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 文件添加页码,以便更好地进行组织管理。

定制化输出效果如何?

如何处理性能问题和大型图片集合?

在处理大型图片集合或高分辨率图片时,应采用异步和多线程技术来提升性能。 对于 Enterprise 级应用,请探索 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 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

审核者
Jeff Fritz
Jeffrey T. Fritz
首席项目经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席项目经理。他是 .NET Conf 虚拟会议系列的执行制片人,并主持“Fritz and Friends”直播节目,每周两次与观众一起谈论技术并编写代码。Jeff 撰写研讨会、演示文稿并计划包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP 峰会在内的最大型微软开发者活动的内容。
准备开始了吗?
Nuget 下载 18,926,724 | 版本: 2026.5 just released
Still Scrolling Icon

还在滚动吗?

想快速获得证据? PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。