跳過到頁腳內容
使用IRONPDF

如何使用C#將圖像轉換為PDF【代碼示例教程】

許多庫允許 C# 開發人員將圖像轉換為 PDF。 找到一個免費、易於使用且性能良好的庫可能很有挑戰性,因為有些庫是付費的、複雜的,或者功能有限。 在這些庫中, IronPDF脫穎而出,成為一個免費、有效率且易於實現的 C# 庫。 它附帶全面的文件和專業的、響應迅速的支援團隊。

IronPDF 是一個 .NET 函式庫,用於在 .NET 專案中產生、讀取、編輯和儲存 PDF 檔案。 IronPDF 為 .NET 5、Core、Standard 和 Framework 提供 HTML 轉 PDF 功能,並完全支援 HTML 轉 PDF,包括 CSS3 和 JS。

讓我們來看看如何建立一個範例專案來學習如何將影像轉換為 PDF。

建立一個 Visual Studio 項目

若要建立新項目,請開啟 Microsoft Visual Studio。 建議使用最新版本的 Visual Studio。 建立新專案的步驟在不同版本之間可能有所不同,但其餘部分在每個版本中都應該相同。

  1. 點選建立新項目。
  2. 選擇專案模板,然後選擇控制台應用程式模板進行本次示範。 您可以根據需要使用任何一種。
  3. 點選"下一步"。 項目名稱。
  4. 按一下"下一步",然後選擇 .NET Framework 版本。
  5. 點選"創建"按鈕。

新項目將按如下所示建立。

如何在 C# 中將圖像轉換為 PDF [程式碼範例教學],圖 1:在 Visual Studio 中建立一個新的控制台應用程式 在 Visual Studio 中建立一個新的控制台應用程式

接下來,在此專案中安裝IronPDF NuGet 套件以使用它的功能。 IronPDF 的有趣之處在於,它無需依賴專有 API,即可輕鬆生成 PDF 文檔,從而避免了用戶遇到的種種煩惱。 HTML轉 PDF 渲染範例能夠從開放標準文件類型(包括 HTML、JS、CSS、JPG、PNG、GIF 和 SVG)渲染出像素級完美的 PDF 檔案。 簡而言之,它利用了開發人員已經掌握的技能。

安裝 IronPDF NuGet 包

若要安裝NuGet 套件,請前往"工具" > "NuGet 套件管理員" > "套件管理器控制台" 。 將出現以下視窗:

如何在 C# 中將圖像轉換為 PDF [程式碼範例教學],圖 2:套件管理器控制台 UI 軟體包管理器控制台使用者介面

接下來,在軟體套件管理器控制台中輸入以下命令:

Install-Package IronPdf

按回車鍵。

如何在 C# 中將映像轉換為 PDF [程式碼範例教學],圖 3:在套件管理器控制台中安裝 IronPdf 套件 在軟體套件管理器控制台中安裝IronPdf軟體包

將圖像文件轉換為 PDF 文檔

下一步將展示如何將以下圖像轉換為 PDF。

範例圖片

如何在 C# 中將圖像轉換為 PDF [程式碼範例教學],圖 4:範例圖片 範例影像

若要使用該庫,請在program.cs檔案中引用 IronPDF 庫。在文件頂部寫入以下程式碼片段。

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel

接下來,在主函數中編寫以下程式碼。 這將把 JPG 檔案轉換為 PDF 檔案。

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
}
public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
}
Public Shared Sub Main(ByVal args() As String)
	' Convert a single image to the PDF document
	Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf("D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage)
	' Save the resulting PDF to the specified path
	doc.SaveAs("D:\Iron Software\ImageToPDF\bird.pdf")
End Sub
$vbLabelText   $csharpLabel

在上面的程式碼範例中,使用了 IronPDF 提供的ImageToPdfConverter類別進行影像轉換。 ImageToPdf方法可用於從影像建立 PDF 文件。 它接受圖像檔案和System.Drawing物件作為輸入。

靜態方法ImageToPdf將單一影像檔案轉換為尺寸相同的 PDF 文件。 它需要兩個參數:影像路徑和影像行為(影像在紙上的顯示方式)。 Imaging.ImageBehavior.CropPage會將紙張大小設定為與影像大小相同。預設頁面大小為 A4。您可以透過以下程式碼行進行設定:

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;
ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;
ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter
$vbLabelText   $csharpLabel

我們提供了多種頁面尺寸選項,您可以根據需要進行設定。

將多個圖像轉換為 PDF 文件

以下範例會將 JPG 影像轉換為新文件。

public static void Main(string[] args)
{
    // Enumerate and filter JPG files from the specified directory
    var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
                                        .Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
    // Convert the images to a PDF document and save it
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(imageFiles);
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
}
public static void Main(string[] args)
{
    // Enumerate and filter JPG files from the specified directory
    var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
                                        .Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
    // Convert the images to a PDF document and save it
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(imageFiles);
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
}
Public Shared Sub Main(ByVal args() As String)
	' Enumerate and filter JPG files from the specified directory
	Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))
	' Convert the images to a PDF document and save it
	Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf(imageFiles)
	doc.SaveAs("D:\Iron Software\ImageToPDF\JpgToPDF.pdf")
End Sub
$vbLabelText   $csharpLabel

在上面的程式碼中, System.IO.Directory.EnumerateFiles會擷取指定資料夾中所有可用的檔案。 Where子句篩選出該資料夾中的所有 JPG 映像,並將它們儲存在imageFiles集合中。 如果您有 PNG 或任何其他圖像格式,只需將其新增至Where查詢即可。

下一行程式碼會將所有影像合併到一個 PDF 文件中。

列印 PDF 文件

以下程式碼片段將列印該文件:

doc.Print();
doc.Print();
doc.Print()
$vbLabelText   $csharpLabel

PdfDocument類別提供的Print方法將使用預設印表機列印文件。 它還提供了更改印表機名稱和其他設定的選項。 有關列印文件的更多詳細信息,請訪問此PDF 列印範例

摘要

本教學展示了一種將影像轉換為 PDF 檔案的簡單方法,並提供了程式碼範例,既可以將單一影像轉換為 PDF,也可以將多個影像合併到一個 PDF 檔案中。此外,它還解釋瞭如何使用一行程式碼列印文件。

此外,IronPDF 的一些重要功能還包括:

-從 URL 產生 PDF 文件。 -加密和解密 PDF 文件。 -合併現有PDF文件

IronPDF提供了許多實用且有趣的功能,請造訪IronPDF主頁以了解更多詳情。

IronPDF是Iron軟體套件的一部分。 Iron Suite 還包含 IronXL、IronBarcode、IronOCR 和 IronWebscraper 等其他有趣的產品,所有這些產品都非常有用。 購買全套 Iron Suite 產品,最高可節省 250%,因為現在只需支付兩件產品的價格,即可獲得全部五件產品。 請造訪許可詳情頁面以了解更多詳情。

常見問題解答

如何在 C# 中將影像轉換為 PDF?

您可以使用 IronPDF 的 ImageToPdf 方法在 C# 中將圖片轉換為 PDF。此方法允許您指定圖片路徑和所需的 PDF 輸出設定。

是否可以將多個影像轉換為單一 PDF 檔案?

是的,IronPDF 使您能夠使用 ImageToPdf 方法將多張圖片轉換為單一 PDF 檔案,您可以提供一個圖片檔案集合。

哪些圖檔格式與轉換為 PDF 相容?

IronPDF 支援將 JPG、PNG、GIF 和 SVG 等多種影像格式轉換成 PDF 文件。

將影像轉換為 PDF 時,如何設定頁面大小?

若要在轉換過程中設定頁面大小,請使用 ImageToPdfConverter 類別中的 PaperSize 屬性,選擇 Letter 或 A4 等標準大小。

是否可以列印 IronPDF 所建立的 PDF 文件?

是的,IronPDF 在 PdfDocument 類中包含一個 Print 方法,允許您使用預設或指定的印表機設定來列印 PDF 文件。

IronPdf 提供哪些附加功能?

IronPDF 提供其他功能,例如從 URL 生成 PDF、加密和解密 PDF、合併 PDF 檔案,以及建立和編輯 PDF 表單。

如何在 Visual Studio 專案中安裝 IronPdf?

若要在 Visual Studio 專案中安裝 IronPDF,請開啟套件管理員控制台,並執行指令 Install-Package IronPdf

使用 IronPDF 生成 PDF 有哪些優勢?

IronPDF 提供了簡單、高效且文件詳盡的 API,可在不依賴專有 API 的情況下生成 PDF。它還能提供專業支援,並有效處理各種 PDF 任務。

IronPDF 是否與 .NET 10 相容,以及如何在 .NET 10 專案中使用 IronPDF 進行影像至 PDF 的轉換?

是的 - IronPDF 與 .NET 10 完全相容,開箱即支持在 .NET 10 專案中將圖片轉換為 PDF。要使用它,請在您的 .NET 10 專案中安裝 IronPDF for .NET NuGet 套件,然後呼叫類似 ImageToPdfConverter.ImageToPdf("path/to/image.png") 的方法來轉換單一張圖片,或傳入圖片路徑的 IEnumerable 來轉換多張圖片。您也可以指定選項,例如 ImageBehavior 或透過 ChromePdfRenderOptions 來自訂渲染選項。此功能與之前的 .NET 版本一樣。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。