如何在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,用于创建数字作品集或报告。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronPDF

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

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

    立即开始在您的项目中使用 IronPDF,免费试用!
    arrow pointer


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

使用 ImageToPdf 类中的 ImageToPdfConverter 静态方法将图像转换为 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图像位于页面右下角。
  • 适合页面图像适合页面。
  • 裁剪页面调整页面以适应图像。

这些放置选项可与 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 渲染选项?

ImageToPdf 静态方法通过导入 HTML <img> 标记来转换图像,然后将 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 下载 17,386,124 | 版本: 2026.2 刚刚发布