如何在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

使用 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?

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

支持哪些图像格式?

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

IronPdf 支持全面的图像格式,包括 JPEG、PNG、BMP 和 GIF 等光栅格式,以及 SVG图形等矢量格式。 该库可处理 WebP 和 AVIF 等标准和现代格式,确保与当代网络应用程序兼容。 为满足专业需求,可使用图标文件(.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 文档,请提供包含文件路径的IEnumerable对象,而不是单个文件路径。 这将生成一个具有默认图像位置和行为的 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 提供各种图像位置和行为选项。 您可以将图片放在页面的中心位置,也可以根据页面大小调整图片,同时保持图片的长宽比。 所有可用的图片位置和行为都是:

  • TopLeftCornerOfPage:图片位于页面左上角。
  • TopRightCornerOfPage:图片位于页面右上角。
  • CenteredOnPage:图片在页面上居中。
  • FitToPageAndMaintainAspectRatio:图片适应页面,同时保持其原始宽高比。
  • BottomLeftCornerOfPage:图片位于页面左下角。
  • BottomRightCornerOfPage:图片位于页面右下角。
  • FitToPage:图片适应页面。
  • CropPage:页面已调整以适应图像。

这些放置选项可与 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 团队成员身着紫色品牌运动服参加公司团队活动
IronSoftware 团队成员身着紫色制服参加公司运动会
Iron Software 团队成员身着紫色运动服装参加公司运动会,并叠加
Iron Software 团队成员身着紫色品牌运动服参加公司体育赛事,上面覆盖品牌文字
IronSoftware 团队成员身着紫色制服参加公司团队活动,
Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

如何自定义 PDF 渲染选项?

静态方法通过将图像作为 HTML 标签导入,然后将 HTML 转换为 PDF 来转换图像。 这样,您可以将ChromePdfRenderOptions对象作为第三个参数传递,以便直接自定义渲染过程。

通过这种方法,您可以访问 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 中添加 页码,以便更好地组织。

定制输出是什么样的?

如何处理性能和大型图像集?

在处理大型图像集或高分辨率图像时,请使用 async 和多线程技术来提高性能。 对于企业应用,请探索 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,135,201 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗?

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