如何将图像转换为 PDF
将图像转换为 PDF 是一个有用的过程，可将多个图像文件合并在一起(如 JPG、PNG 或 TIFF)转换成一个单一的PDF文件。 这通常是为了创建数字化的作品集、演示文稿或报告，从而更容易地以更有组织且普遍可读的格式共享和存储图像集合。
IronPdf允许您将单个或多个图像转换为具有唯一性的PDF。图像位置和行为. 这些行为包括适应页面、页面居中和裁剪页面。 此外，您可以添加文本和 HTML 页眉和页脚, 应用水印还可以设置自定义页面大小，以及背景和前景叠加。
如何将图像转换为 PDF
开始在您的项目中使用IronPDF，并立即获取免费试用。
查看 IronPDF 上 Nuget 用于快速安装和部署。它有超过800万次下载，正在使用C#改变PDF。
考虑安装 IronPDF DLL 直接。下载并手动安装到您的项目或GAC表单中： IronPdf.zip
将图像转换为PDF示例
使用 ImageToPdfConverter 类中的 ImageToPdf 静态方法将图像转换为PDF文档。 此方法仅需要图像的文件路径，然后它将使用默认的图像放置和行为将其转换为PDF文档。 支持的图像格式包括.bmp、.jpeg、.jpg、.gif、.png、.svg、.tif、.tiff、.webp、.apng、.avif、.cur、.dib、.ico、.jfif、.jif、.jpe、.pjp 和 .pjpeg。
图片样本
代码
:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.csusing 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文档。
:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.csusing 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
图像放置和行为
为了使用方便，我们提供了一系列有用的图像放置和行为选项。 例如，您可以将图像居中显示在页面上，或者调整其大小以适应页面尺寸，同时保持其长宽比。 所有可用的图像位置和行为如下：
- 页面左上角： 图片放置在页面的左上角。
- TopRightCornerOfPage： 图像放置在页面的右上角。
- CenteredOnPage： 图像在页面上居中。
- FitToPageAndMaintainAspectRatio: 图像适应页面的同时保持其原始宽高比。
- 页面左下角： 图像被放置在页面的左下角。
- BottomRightCornerOfPage： 图像被放置在页面的右下角。
- FitToPage: 图像适应页面。
- 裁剪页面： 页面调整以适应图像。
:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.csusing 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")图像行为比较
 页面左上角 |  页面右上角 |
 以页面为中心 |  适合页面并保持宽高比 |
 页面左下角 |  页面右下角 |
 FitToPage |  作物页面 |
应用渲染选项
将各种类型的图像转换为PDF文档的关键是在ImageToPdf静态方法的控制下，将图像作为HTML img标签导入，然后将HTML转换为PDF。 这也是我们可以将 ChromePdfRenderOptions 对象作为 ImageToPdf 方法的第三个参数传递，以直接自定义渲染过程的原因。
:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.csusing 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")输出 PDF
如果您想将 PDF 文档转换或光栅化为图像，请参阅我们的如何将PDF光栅化为图像文章
