1. IronPDF
  2. 操作指南
  3. 图像转PDF

如何将图像转换为 PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

由 查克尼特·宾

将图像转换为 PDF 是一个有用的过程，可将多个图像文件合并在一起(如 JPG、PNG 或 TIFF)转换成一个单一的PDF文件。 这通常是为了创建数字化的作品集、演示文稿或报告，从而更容易地以更有组织且普遍可读的格式共享和存储图像集合。

通过 IronPdf，您可以将单张或多张图片转换为 PDF，并具有独特的图像位置和行为. 这些行为包括适应页面、页面居中和裁剪页面。 此外，您可以添加使用 IronPDF 制作文本和 HTML 页眉页脚, 使用 IronPDF 应用水印还可以设置自定义页面大小，以及背景和前景叠加。

开始使用IronPDF

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：
green arrow pointer

如何将图像转换为 PDF

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


将图像转换为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.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")
VB   C#

输出 PDF

将图像转换为PDF示例

要将多张图片转换为PDF文档，您应该提供一个包含文件路径的IEnumerable对象，而不是单个文件路径，如我们之前的示例所示。 这将再次生成一个具有默认图像放置和行为的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")
VB   C#

输出 PDF

图像放置和行为

为了使用方便，我们提供了一系列有用的图像放置和行为选项。 例如，您可以将图像居中显示在页面上，或者调整其大小以适应页面尺寸，同时保持其长宽比。 所有可用的图像位置和行为如下：

  • 页面左上角： 图片放置在页面的左上角。
  • TopRightCornerOfPage： 图像放置在页面的右上角。
  • CenteredOnPage： 图像在页面上居中。
  • FitToPageAndMaintainAspectRatio: 图像适应页面的同时保持其原始宽高比。
  • 页面左下角： 图像被放置在页面的左下角。
  • BottomRightCornerOfPage： 图像被放置在页面的右下角。
  • FitToPage: 图像适应页面。
  • 裁剪页面： 页面调整以适应图像。
: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")
VB   C#

图像行为比较

将图片放在页面左上角

页面左上角

将图片放在页面右上方

页面右上角

将图像放在页面中央

以页面为中心

在保持长宽比的同时，将图像调整到页面上

适合页面并保持宽高比

将图片放在页面左下方

页面左下角

将图片放在页面右下方

页面右下角

拉伸图像以适应页面

FitToPage

裁剪页面以适应图像

作物页面

应用渲染选项

在 ImageToPdf 静态方法的引擎盖下，将各种类型的图像转换为 PDF 文档的关键是将图像作为 HTML ImageToPdf 导入。 related to 应用渲染选项标记，然后将 HTML 转换为 PDF。 这也是我们可以将 ChromePdfRenderOptions 对象作为 ImageToPdf 方法的第三个参数传递，以直接自定义渲染过程的原因。

: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")
VB   C#

输出 PDF

如果您想将 PDF 文档转换或光栅化为图像，请参阅我们的如何将 PDF 光栅化为图像的指南.

Chaknith related to 输出 PDF

查克尼特·宾

软件工程师

Chaknith 是开发者中的福尔摩斯。他第一次意识到自己可能在软件工程方面有前途，是在他出于乐趣做代码挑战的时候。他的重点是 IronXL 和 IronBarcode，但他为能帮助客户解决每一款产品的问题而感到自豪。Chaknith 利用他从直接与客户交谈中获得的知识，帮助进一步改进产品。他的轶事反馈不仅仅局限于 Jira 票据，还支持产品开发、文档编写和市场营销，从而提升客户的整体体验。当他不在办公室时，他可能会在学习机器学习、编程或徒步旅行。