如何將圖片轉換為 PDF

查克尼思·賓

2023年9月21日

已更新 2024年12月10日

Translated

View the article in English

將圖像轉換為 PDF 是一種有用的過程，將多個圖像文件（如 JPG、PNG 或 TIFF）合併成單一的 PDF 文件。這通常用於創建數字化作品集、演示文稿或報告，使分享和存儲一系列圖像更加容易、有序且普遍可讀。

IronPDF 允許您將單一或多個圖像轉換為具有獨特圖像擺放和行為的 PDF。這些行為包括適合頁面、頁面居中和裁剪頁面。此外，您可以使用IronPDF 添加文字和 HTML 頁首和頁尾，使用 IronPDF 來添加浮水印，設置自定義頁面尺寸，並包括背景和前景覆蓋。

開始使用IronPDF

立即在您的專案中使用IronPDF，並享受免費試用。

第一步：

如何將圖片轉換為 PDF

下載將圖像轉換為PDF的IronPDF C#庫
準備要轉換的影像或影像
將圖像路徑提供給 ImageToPdf 靜態方法
調整輸出 PDF 中的影像放置和行為
使用 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")

$vbLabelText $csharpLabel

輸出 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")

$vbLabelText $csharpLabel

輸出 PDF

圖片放置和行為

为了使用方便，我们提供了多种有用的图像放置和行为选项。例如，您可以將圖像置於頁面中央，或者將其調整至頁面大小，同時保持其縱橫比。所有可用的影像位置和行為如下：

頁面左上角： 圖像被放置在頁面的左上角。
TopRightCornerOfPage：影像放置在頁面的右上角。
CenteredOnPage：圖片置中於頁面。
FitToPageAndMaintainAspectRatio：圖像在保持其原始長寬比的同時適合頁面。
BottomLeftCornerOfPage： 圖像位於頁面的左下角。
BottomRightCornerOfPage：圖像放置在頁面的右下角。
FitToPage: 圖像適合頁面。
CropPage：頁面已調整以適應圖像。

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

$vbLabelText $csharpLabel

影像行為比較

TopLeftCornerOfPage	TopRightCornerOfPage
CenteredOnPage	FitToPageAndMaintainAspectRatio
BottomLeftCornerOfPage	BottomRightCornerOfPage
FitToPage	CropPage

套用渲染選項

將各類型的影像轉換成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.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")

$vbLabelText $csharpLabel

輸出 PDF

如果您想將 PDF 文件轉換或光柵化為圖像，請參閱我們的將 PDF 光柵化為圖像的指南。

查克尼思·賓

立即與工程團隊聊天

軟體工程師

Chaknith 是開發者界的夏洛克福爾摩斯。他第一次意識到自己可能有個軟體工程的未來，是在他為了娛樂而參加程式挑戰的時候。他的重點是 IronXL 和 IronBarcode，但他也引以為豪的是，他幫助客戶解決所有產品的問題。Chaknith 利用他與客戶直接對話中獲得的知識，以進一步改進產品。他的實際反饋超越了 Jira 工單，並支持產品開發、文件撰寫和行銷，以提升客戶的整體體驗。不在公司時，他通常在學習機器學習、寫程式和徒步旅行。