如何用 C# 实现图片转PDF
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,用于创建数字作品集或报告。
最小工作流程(5 个步骤)
- 下载用于将图像转换为 PDF 的 IronPDF C# 库。
- 准备您要转换的图像
- 为 `ImageToPdf` 静态方法提供图像路径
- 调整输出PDF中的图像位置和行为
- 使用IronPDF添加自定义文本和HTML页眉页脚
如何将单张图像转换为 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 安装程序。 该库可在Windows、macOS和Linux平台上无缝运行,因此适用于各种开发环境。
支持哪些图像格式?
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")
对于更高级的应用场景,请探索 异步生成 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")
多图像 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")
图像行为之间的视觉差异是什么?
`页面左上角` |
`页面右上角` |
`CenteredOnPage` |
`FitToPageAndMaintainAspectRatio` |
`页面左下角` |
`页面右下角` |
`FitToPage` |
`裁剪页面` |
如何自定义 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")
如需了解更复杂的页眉和页脚要求,请参阅我们的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 文档中的显示效果,确保视觉内容的专业呈现。

