1. IronPDF
  2. 操作指南
  3. 图像到PDF
如何在C#中将图像转换为PDF

Curtis Chau
Curtis Chau
已更新:

如何用 C# 将图像转换为 PDF IronPDF 使 C# 开发人员能够使用 `ImageToPdfConverter.ImageToPdf` 方法将单个或多个图像（JPG、PNG、TIFF）转换为 PDF 文档，并可自定义放置行为和渲染选项。 将图像转换为 PDF 将多个图像文件（如 JPG、PNG 或 TIFF）合并为一个 PDF 文档。 该流程可创建数字作品集、演示文稿或报告，从而更方便地以有组织、通用可读的格式共享和存储图片集。 IronPDF 可将单张或多张图像转换为 PDF，并具有独特的 [图像位置和行为](#anchor-export-image-behaviors)。 这些行为包括适应页面、居中页面和裁剪页面。 另外，您可以通过IronPDF[添加文本和HTML页眉和页脚](/how-to/headers-and-footers/)，[应用水印](/tutorials/csharp-edit-pdf-complete-tutorial/#add-a-watermark-to-a-pdf)，设置自定义页面大小，并包含背景和前景叠加。 *as-heading:2(快速入门：使用IronPDF将图像转换为PDF)* 使用 IronPDF 的 `ImageToPdfConverter` 类将图像转换为 PDF 文档。 本示例演示了如何将图像文件转换为 PDF，使您能够将图像转 PDF 功能集成到您的 .NET C# 应用程序中。 使用最少的代码，您就可以将图像转换为 PDF，用于创建数字作品集或报告。 ```cs :title=Convert image(s) to PDF in one line! IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf"); ```

最小工作流程（5 个步骤）

  1. 下载用于将图像转换为 PDF 的 IronPDF C# 库。
  2. 准备您要转换的图像
  3. 为 ImageToPdf 静态方法提供图像路径
  4. 调整输出PDF中的图像位置和行为
  5. 使用IronPDF添加自定义文本和HTML页眉页脚

如何将单张图像转换为 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](/get-started/installation-overview/) 或下载了[Windows 安装程序](/get-started/ironpdf-installer/)。 该库可在[Windows](/get-started/windows/)、[macOS](/get-started/macos/)和[Linux](/get-started/linux/)平台上无缝运行，因此适用于各种开发环境。

支持哪些图像格式？
IronSoftware 团队成员身着紫色制服出席公司活动
IronPdf 支持全面的图像格式，包括 JPEG、PNG、BMP 和 GIF 等光栅格式，以及 [SVG图形](/how-to/SVGs/)等矢量格式。 该库可处理 WebP 和 AVIF 等标准和现代格式，确保与当代网络应用程序兼容。 为满足专业需求，可使用图标文件（.ico）和光标文件（.cur）。

如何编写代码？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs ``` 对于更高级的应用场景，请探索 [异步生成 PDF](/how-to/async/) 以提高处理多个图像时的性能。 该库还支持[自定义纸张大小](/how-to/自定义纸张大小/)和[自定义页边距](/how-to/自定义页边距/)，以确保您的图像按需显示。

输出结果是什么样的？

如何将多个图像转换为 PDF？ 要将多个图像转换为 PDF 文档，请提供一个包含文件路径（而不是单个文件路径）的 **`IEnumerable`**对象。 这将生成一个具有默认图像位置和行为的 PDF 文档。 在处理多张图片时，请考虑使用[PDF压缩选项](/how-to/pdf-compression/)来优化文件大小，同时不影响质量。 在创建大型作品集或相册时，这一点尤为重要。

如何一次处理多张图片？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs ```

多图像 PDF 看起来像什么？

如何控制图像位置和行为？ IronPdf 提供各种图像位置和行为选项。 您可以将图片放在页面的中心位置，也可以根据页面大小调整图片，同时保持图片的长宽比。 所有可用的图片位置和行为都是： - **`TopLeftCornerOfPage`：**图像位于页面左上角。 - **`TopRightCornerOfPage`：**图像位于页面右上角。 - **`CenteredOnPage`:**图像位于页面中央。 - **`FitToPageAndMaintainAspectRatio`：**图像适合页面，同时保持其原始长宽比。 - **`BottomLeftCornerOfPage`：**图像位于页面左下角。 - **`BottomRightCornerOfPage`：**图像位于页面右下角。 - **`适合页面`：**图像适合页面。 - **`裁剪页面`：**调整页面以适应图像。 这些放置选项可与 IronPDF 的[页面方向和旋转](/how-to/page-orientation-rotation/)功能无缝配合，无论您的图像尺寸如何，都可以创建专业外观的文档。

如何在代码中应用图像行为？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs ```

图像行为之间的视觉差异是什么？
Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

<代码>页面左上角

Iron Software 团队成员身着紫色品牌运动服参加公司户外活动

<代码>页面右上角

Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

<代码>CenteredOnPage

IronSoftware 团队成员身着紫色制服参加公司运动会

<代码>FitToPageAndMaintainAspectRatio

Iron Software 团队成员身着紫色运动服装参加公司运动会，并叠加

<代码>页面左下角

Iron Software 团队成员身着紫色品牌运动服参加公司体育赛事，上面覆盖品牌文字

<代码>页面右下角

IronSoftware 团队成员身着紫色制服参加公司团队活动，

<代码>FitToPage

Iron Software 团队成员身着紫色品牌运动服参加公司团队活动

<代码>裁剪页面

如何自定义 PDF 渲染选项？ `ImageToPdf` 静态方法通过导入 HTML ` related to 在 C# .NET 中将图像转换为 PDF - 完全指南 | IronPDF for .NET. 用 IronPDF 在 C# 中将图像转...` 标记来转换图像，然后将 HTML 转换为 PDF。 这允许您将 **`ChromePdfRenderOptions`** 对象作为第三个参数传递，以直接自定义呈现过程。 通过这种方法，您可以访问 IronPDF 中所有强大的[渲染选项](/how-to/rendering-options/)，包括 JavaScript 执行、CSS 媒体类型和视口配置。 您甚至可以加入[网络字体和图标](/how-to/webfonts-webicons/)，以增强文档的视觉吸引力。

如何添加页眉和自定义样式？ ```csharp :path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs ``` 对于更复杂的页眉和页脚要求，请参阅我们关于[HTML 页眉和页脚的](/examples/html-headers-and-footers/)综合指南。 您还可以在基于图像的 PDF 中添加 [页码](/how-to/page-numbers/)，以便更好地组织。

定制输出是什么样的？

如何处理性能和大型图像集？ 在处理大型图像集或高分辨率图像时，请使用 [async 和多线程](/how-to/async/)技术来提高性能。 对于企业应用，请探索 IronPDF 的性能优化策略，以确保即使在工作量很大的情况下也能流畅运行。 此外，在处理存储在云服务中的图像时，请查看我们的[从 Azure Blob Storage 嵌入图像](/how-to/images-azure-blob-storage/)指南，以实现无缝云集成。

如何将 PDF 转换回图像？ 要将 PDF 文档转换或光栅化为图像，请参阅我们的[指南，了解如何将 PDF 光栅化为图像](/how-to/rasterize-pdf-to-images/)。 准备好看看您还能做些什么吗？ 查看我们的教程页面：[转换PDF文档](https://ironpdf.com/tutorials/convert-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
  立即与工程团队聊天
技术作家

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,012,929 | 版本: 2025.12 刚刚发布