如何在 C# 中將圖像轉換為 PDF(圖片轉PDF)
IronPDF使 C# 開發人員能夠使用 ImageToPdfConverter.ImageToPdf 方法將單一或多個影像(JPG、PNG、TIFF)轉換為 PDF 文檔,並提供可自訂的放置行為和渲染選項。
將影像轉換為 PDF 可以將多個影像檔案(例如 JPG、PNG 或 TIFF)合併到一個 PDF 文件中。 此流程可建立數位作品集、簡報或報告,從而更容易以有條理且普遍可讀的格式共用和儲存影像集。
IronPDF可以將單一或多個影像轉換為具有獨特影像位置和行為的PDF 檔案。 這些行為包括適應頁面、居中顯示和裁剪頁面。 此外,您還可以使用IronPDF新增文字和 HTML 頁首和頁腳,使用IronPDF應用浮水印,設定自訂頁面大小,以及新增背景和前景疊加層。
快速入門:使用IronPDF圖片轉PDF
使用 IronPDF 的 ImageToPdfConverter 類別將影像轉換為 PDF 文件。 本範例示範如何將影像檔案轉換為 PDF,從而可以將影像轉 PDF 功能整合到.NET C# 應用程式中。 只需編寫少量程式碼,即可將影像轉換為 PDF,用於建立數位作品集或報告。
最簡工作流程(5個步驟)
- 下載IronPDF C# 庫,用於將圖像轉換為 PDF
- 準備好要轉換的圖像。
- 向`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。
開始之前,請確保您已透過NuGet安裝IronPDF或下載了Windows 安裝程式。 此程式庫可在Windows 、 macOS和Linux平台上無縫運行,使其適用於各種開發環境。
支援哪些圖像格式?
IronPDF支援多種影像格式,包括 JPEG、PNG、BMP 和 GIF 等光柵格式,以及SVG 圖形等向量格式。 該程式庫可處理 WebP 和 AVIF 等標準格式和現代格式,確保與現代 Web 應用程式相容。 對於特殊需求,請使用圖示檔案(.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")
圖像行為之間有哪些視覺差異?
`TopLeftCornerOfPage` |
`TopRightCornerOfPage` |
`CenteredOnPage` |
`FitToPageAndMaintainAspectRatio` |
`BottomLeftCornerOfPage` |
`BottomRightCornerOfPage` |
`FitToPage` |
`CropPage` |
如何自訂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 檔案添加頁碼,以便更好地進行組織。
自訂輸出是什麼樣的?
如何處理高性能和大型影像集合?
處理大型影像集或高解析度影像時,應採用非同步和多執行緒技術來提高效能。 對於企業應用,探索 IronPDF 的效能最佳化策略,以確保即使在大量工作負載下也能流暢運作。
此外,在使用儲存在雲端服務中的映像時,請查看我們關於嵌入 Azure Blob 儲存體中的映像以實現無縫雲端整合的指南。
如何將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 文件中的顯示方式,確保專業呈現您的視覺內容。

