IRONSOFTWAREHOME

如何用 C# 将图像转换为 PDF

Curtis Chau
Curtis Chau
Updated: 2026年9月5日

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. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

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

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

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

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

在ImageToPdf静态方法将图像转换为PDF文档。 此方法只需提供图像的文件路径,并将其转换为具有默认图像位置和行为的 PDF 文档。 支持的图像格式包括.bmp、.jpeg、.jpg、.gif、.png、.svg、.tif、.tiff、.webp、.apng、.avif、.cur、.dib、.ico、.jfif、.jif、.jpe、.pjp和.pjpeg。

在开始之前,请确保您已通过 NuGet 安装了 IronPDF 或下载了Windows 安装程序。 该库可在Windows、macOS和Linux平台上无缝运行,因此适用于各种开发环境。

支持哪些图像格式?

Iron Software团队成员在公司活动中穿着紫色制服

IronPDF 支持全面的图像格式,包括 JPEG、PNG、BMP 和 GIF 等光栅格式,以及 SVG图形等矢量格式。 该库可处理 WebP 和 AVIF 等标准和现代格式,确保与当代网络应用程序兼容。 为满足专业需求,可使用图标文件(.ico)和光标文件(.cur)。

如何编写代码?

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

对于更高级的应用场景,请探索 异步生成 PDF 以提高处理多个图像时的性能。 该库还支持自定义纸张大小和自定义页边距,以确保您的图像按需显示。

输出结果是什么样的?


如何将多个图像转换为 PDF?

要将多个图像转换为PDF文档,请提供一个包含文件路径而非单个文件路径的IEnumerable对象。 这将生成一个具有默认图像位置和行为的 PDF 文档。

在处理多张图片时,请考虑使用PDF压缩选项来优化文件大小,同时不影响质量。 在创建大型作品集或相册时,这一点尤为重要。

如何一次处理多张图片?

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");

多图像 PDF 看起来像什么?


我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能,比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本,同时提高生产力,并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官,OPYN

查看案例研究

如何控制图像位置和行为?

IronPDF 提供各种图像位置和行为选项。 您可以将图片放在页面的中心位置,也可以根据页面大小调整图片,同时保持图片的长宽比。 所有可用的图片位置和行为都是:

  • ``TopLeftCornerOfPage: 图片放置在页面的左上角。
  • ``TopRightCornerOfPage: 图片放置在页面的右上角。
  • ``CenteredOnPage: 图片居中于页面。
  • ``FitToPageAndMaintainAspectRatio: 图片适应页面,同时保持其原始纵横比。
  • ``BottomLeftCornerOfPage: 图片放置在页面的左下角。
  • ``BottomRightCornerOfPage: 图片放置在页面的右下角。
  • ``FitToPage: 图片适合页面。
  • ``CropPage: 页面调整以适应图片。

这些放置选项可与 IronPDF 的页面方向和旋转功能无缝配合,无论您的图像尺寸如何,都可以创建专业外观的文档。

如何在代码中应用图像行为?

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");

图像行为之间的视觉差异是什么?

Iron Software 团队成员身着紫色品牌运动服参加公司团队活动
Iron Software 团队成员身着紫色品牌运动服参加公司户外活动
Iron Software 团队成员身着紫色品牌运动服参加公司团队活动
Iron Software团队成员穿着紫色制服参加公司体育活动
Iron Software 团队成员身着紫色运动服装参加公司运动会,并叠加“认识我们的团队”
Iron Software 团队成员身着紫色品牌运动服参加公司体育赛事,上面覆盖品牌文字
Iron Software团队成员穿着紫色制服参加公司团队活动,文字叠加'认识我们的团队'
Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

如何自定义 PDF 渲染选项?

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

通过这种方法,您可以访问 IronPDF 中所有强大的渲染选项,包括 JavaScript 执行、CSS 媒体类型和视口配置。 您甚至可以加入网络字体和图标,以增强文档的视觉吸引力。

如何添加页眉和自定义样式?

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");

如需了解更复杂的页眉和页脚要求,请参阅我们的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 文档中的显示效果,确保视觉内容的专业呈现。

What are the rendering customization options available in IronPDF?

IronPDF allows you to use the `ChromePdfRenderOptions` object to customize the rendering process. This includes options like JavaScript execution, CSS media types, and custom headers. You can also incorporate web fonts and icons for a more polished document.

Is it possible to convert a PDF back to an image using IronPDF?

Yes, IronPDF supports converting or rasterizing PDF documents back into images. This can be useful for various applications that require different formats for distribution or presentation.

Can IronPDF work on different operating systems?

IronPDF is versatile and can operate across Windows, macOS, and Linux environments, making it an excellent choice for various development platforms.

How do I optimize PDF size when combining multiple images using IronPDF?

IronPDF offers PDF compression options to optimize the file size when merging multiple images. It's especially useful when creating large digital portfolios or photo albums, ensuring quality is maintained without large file sizes.

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

准备开始了吗?

Nuget Downloads 21,253,952版本:2026.10刚刚发布

免费获取

30天试用密钥 即刻获取。

bullet_checked无需信用卡或创建账户
bullet_test在生产环境中测试
且无水印
bullet_calendar30天完全
功能性产品
bullet_support试用期间提供
24/5技术支持
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.10

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
您的资料将始终保密。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
深受全球数百万工程师信赖
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.10

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.10

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起