C# PDF 轉換(開發者教學)
C# PDF 轉換(開發者教學)
IronPDF 讓您在 C# 應用程式中使用幾行程式碼將文件轉換為 PDF。 它可以無縫地在 Windows、Linux 和 macOS 平台上處理 HTML 到 PDF 和映像到 PDF 的轉換。
本文將向您展示如何使用IronPDF (適用於 .NET 和 .NET Core 的 PDF 程式庫)進行 PDF 轉換。 無論您使用的是Windows 、 Linux還是macOS ,IronPDF 都能為您的所有 PDF 需求提供跨平台支援。 圖書館提供全面的文件和教程,幫助您快速入門。
IronPDF是什麼?
- PDF 產生:使用 C# 以程式設計方式輕鬆地從各種來源(包括 HTML、圖像、文字和現有文件)建立 PDF 文件。
- HTML 轉 PDF 轉換:將 HTML 內容(包括網頁或 HTML 範本)轉換為高品質的 PDF,並可完全控制樣式和格式。 3.影像轉 PDF :將影像檔案(如 JPEG、PNG 或 BMP)轉換為 PDF 文檔,以便輕鬆地將影像整合到 PDF 報告和文件中。
- PDF 操作:全面的 PDF 編輯功能,包括從 PDF 中提取文字、合併和分割 PDF 、旋轉,以及新增、修改或刪除內容和註釋。
- PDF 表單:建立、填寫和提取PDF 表單中的數據,使其適用於需要互動式表單和資料收集的應用程式。
無論您需要從頭開始產生 PDF ,將HTML 頁面、圖像或現有文件轉換為 PDF 格式,還是操作現有 PDF ,IronPDF 都提供了簡單易用的 API 來完成這些任務。 該庫使用Chrome 渲染引擎,以確保您的 HTML 轉換結果完全符合預期。 如需查看完整的功能列表,請造訪IronPDF 功能概述網站。
- PDF 生成:透過程式設計方式從 HTML、圖像、文字和文件建立 PDF 。 支援自訂尺寸、方向和邊距。 也支援國際語言。
- HTML 轉 PDF :將 HTML 轉換為 PDF,並保留所有樣式。 支援CSS 媒體、 JavaScript和Web 字體。 支援WebGL和響應式設計。 3.圖片轉 PDF :將 JPEG、PNG 或 BMP 檔案轉換為 PDF。 支援TIFF格式轉換和SVG圖形。 可以使用 DataURI 嵌入影像。
- PDF 操作:編輯 PDF,包括文字擷取、合併/分割和註釋。 還可以編輯文字、新增圖章和管理元資料。
- PDF 表單:建立和填寫PDF 表單。 支援建立和編輯表單。 可以將PDF文件展平為靜態內容。
如何建立一個新的 Visual Studio 專案?
在深入程式碼之前,讓我們先建立一個新的 C# 控制台應用程式專案。 如果您是 .NET 開發新手,快速入門指南可能會對您有所幫助,其中包含更多設定技巧。 F# 開發人員也可以使用 IronPDF 進行函數式程式設計。
開啟 Visual Studio,然後按一下"檔案">"新建">"專案"建立一個新專案。
Visual Studio 檔案選單已展開,顯示各種選項,包括新專案、複製儲存庫、開啟檔案/專案和儲存選項以及鍵盤快捷鍵。 Visual Studio 中的"檔案"功能表提供了對基本專案管理功能的快速訪問,從建立新專案到從版本控制系統複製儲存庫。
出現一個新視窗。 選擇控制台應用程式模板,然後按一下底部的"下一步" 。 此範本非常適合在學習 PDF 基礎知識之前,先學習Blazor 應用程式或ASP.NET MVC等複雜專案類型。
Visual Studio 的"建立新專案"對話方塊顯示已選擇控制台應用程式模板,用於建立支援 Windows、Linux 和 macOS 的 .NET Core 命令列應用程式。 Visual Studio 中的控制台應用程式範本為使用 .NET Core 建立跨平台命令列應用程式提供了一個起點。
在下一個視窗中,為您的專案命名並選擇一個位置,然後按一下"下一步" 。 考慮將專案整理到專用資料夾中,以便輕鬆存取程式碼範例和範例文件。
Visual Studio 的"設定新專案"對話方塊顯示了名為"PDF 轉換"的控制台應用程式的設置,包括專案位置和解決方案設定。 步驟 2:為 PDF 轉換應用程式設定新的控制台應用程式項目,設定適當的名稱和位置。
選擇目標框架,然後按一下"建立" 。 對於現代應用程序,請使用.NET 6 或更高版本以獲得最佳效能和支援。 最新版本提供了更高的效能和非同步功能。
Visual Studio 專案建立對話方塊顯示"附加資訊"頁面,其中已選擇 .NET 5.0 作為控制台應用程式的目標框架。 在 Visual Studio 中建立新的控制台應用程式的最後一步,即選擇目標框架。 請注意,.NET 5.0 已標記為"停止支援"—對於當前項目,請考慮使用 .NET 6.0 或 .NET 8.0。
您的專案已準備就緒。 我們來安裝IronPDF。
如何安裝 IronPDF?
IronPDF 提供多種安裝方法。 我們將使用 NuGet 套件管理器。 您可以探索特定場景的進階安裝方法,包括Windows Installer選項和Linux 配置。
- 在 Visual Studio 中,開啟"工具"功能表,並將滑鼠停留在 NuGet 套件管理器上。
按一下"管理解決方案的 NuGet 套件"。
Visual Studio 工具選單已展開,顯示 NuGet 套件管理器子選單,其中包含"套件管理器控制台"、"管理解決方案的 NuGet 套件"和"套件管理器設定"等選項。 Visual Studio 中的"工具"功能表提供了對 NuGet 套件管理器功能的訪問,這些功能對於管理 .NET 專案中的外部程式庫和相依性至關重要。
- 出現一個新視窗。 點選"瀏覽"選項卡,搜尋"IronPDF"。
- 選擇 IronPDF 並點選"安裝"。 對於較小的部署,請考慮使用IronPdf.Slim 。
您也可以透過軟體套件管理器控制台進行安裝:
Install-Package IronPdf
或直接從IronPDF NuGet 頁面下載。 對於容器,請參閱Docker 部署指南或將 IronPDF 作為遠端容器運行。
如何使用 IronPDF 將文件轉換為 PDF?
讓我們來探討如何將不同文件格式轉換為 PDF。 IronPDF 提供豐富的渲染選項,用於自訂輸出,包括自訂日誌記錄和效能監控。
- 將 HTML 文件轉換為 PDF 文檔
- 將影像轉換為 PDF 文檔
如何將HTML檔案轉換為PDF?
使用 IronPDF 將 HTML 轉換為 PDF 非常簡單。 該程式庫支援進階功能,如頁首和頁尾、分頁符號和自訂 CSS 。 您可以處理Bootstrap 佈局並為已認證內容實現cookie 管理。
以下是如何將HTML檔案轉換為PDF檔案的方法:
using IronPdf;
// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();
// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";
// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;
// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");
// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;
// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");
// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");using IronPdf;
// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();
// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";
// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;
// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");
// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;
// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");
// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");這段程式碼將 HTML 檔案(" invoice.html ")轉換為 PDF 文件。 透過建立ChromePdfRenderer ,您可以使用 Chromium 引擎來確保準確轉換,從而保持網頁的外觀。 渲染選項可讓您設定自訂頁邊距和紙張尺寸。產生的 PDF 檔案會透過簡單的SaveAs呼叫儲存為" output.pdf "。 這種簡化的流程使得在 C# 中產生 PDF 時,HTML 到 PDF 的轉換變得簡單直接。
對於複雜的場景,可以探索將 URL 轉換為 PDF 、處理HTML 字串或在 ASP.NET MVC 應用程式中轉換 CSHTML 檔案。 您也可以渲染 JavaScript 圖表並處理Angular 應用程式。
HTML 轉換 PDF 輸出結果是什麼樣子的?
PDF 檢視器介面顯示了一個範例發票模板,其中包含佔位符公司資訊、總計 190.00 美元的兩項商品以及導航控制項。 這是一個在 PDF 閱讀器中查看的基本發票範本範例,展示了標準的發票要素,包括寄件者/收件人詳細資料、服務明細和價格計算。
如何將圖片轉換為PDF?
讓我們把圖片轉換成PDF文件。 只需編寫少量程式碼,即可轉換 JPEG、PNG、BMP 和SVG 檔案。 該庫還支援高級功能,例如繪製線條和矩形,或為現有 PDF添加文字和點陣圖。
我可以轉換哪些影像格式?
IronPDF 主頁截圖,展示了 C# PDF 庫在 .NET 應用程式中建立、編輯和讀取 PDF 的關鍵功能。 IronPDF 提供了一個全面的 C# PDF 程式庫,支援 HTML 到 PDF 的轉換、跨平台相容性,以及 50 多個用於 .NET 應用程式中 PDF 操作的功能。
using IronPdf;
using System.IO;
using System.Linq;
// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));
// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();
// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;
// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);
// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale
// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");
// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");
// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");using IronPdf;
using System.IO;
using System.Linq;
// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));
// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();
// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;
// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);
// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale
// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");
// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");
// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");這段程式碼展示了兩種方法:批量轉換多個 PNG 檔案和單一影像轉換。 它會在 assets 資料夾中找到所有 PNG 文件,並使用ImageToPdfConverter.ImageToPdf將它們轉換為 PDF。 ImageBehavior屬性控製影像在頁面上的位置。 最後,它使用SaveAs儲存 PDF。
若要進行進階影像處理,請探索嵌入來自 Azure Blob 儲存體的映像或使用 Base64 編碼的影像。 您也可以將 PDF 文件柵格化為圖像,以便進行反向轉換。
圖片轉PDF輸出結果是什麼樣子的?
! IronPDF 文件網頁截圖,顯示了 C# PDF 庫主頁,其中包含用於在 .NET 應用程式中建立和編輯 PDF 的功能 IronPDF庫主頁展示了其主要功能,包括HTML轉PDF、對.NET框架的跨平台支持,以及醒目的"30天免費試用"按鈕。
有哪些進階PDF轉換功能?
除了基本的 HTML 和影像轉換功能外,IronPDF 還提供許多進階功能,可進行全面的 PDF 處理。 該庫支援非同步操作和並行處理,適用於高效能場景。
哪些文檔類型可以轉換為PDF?
IronPDF支援多種格式的轉換:
- DOCX 轉 PDF並支援郵件合併功能
- RTF 轉 PDF,用於富文本格式文件
- 使用 XSLT 轉換將 XML 轉換為 PDF -將 Markdown 轉換為 PDF以用於文件編寫
- MAUI 應用程式中的XAML 轉 PDF 包含多個資源的HTML ZIP 文件
如何優化生成的PDF文件?
將文件轉換為 PDF 格式後,可使用下列方法增強文件:
如何最佳化PDF轉換性能?
為了獲得更好的應用程式效能:
那麼,平台特定因素又該如何考慮呢?
IronPDF提供全面的平台支援: -安卓行動應用部署
- Web 伺服器的IIS 配置
- Azure 應用程式服務最佳化
- AWS Lambda 函數 -原生引擎與遠端引擎選項
有哪些關鍵要點?
本文探討如何使用 C# 進行 PDF 轉換,以實現文件管理和共享。 透過 C# 和 IronPDF,您可以輕鬆地將 PDF 功能整合到您的應用程式中。 從生成 PDF 到轉換 HTML、圖像和現有文檔,IronPDF 提供全面的功能。 程式碼範例展示如何以最少的努力將 HTML 文件和圖像轉換為 PDF。
IronPDF的優勢在於其全面性的功能:
- 支援Windows 、 Linux 、 macOS和雲端平台等跨平台環境
- 支援多種轉換格式,包括 HTML、圖片、DOCX、RTF 等 -高級功能,例如數位簽章、加密、表單和註釋
- 透過非同步操作和並行處理優化效能
- 使用 Chrome 渲染引擎實現像素級完美渲染
- 包含API 參考和故障排除指南的完整文檔
如圖所示,IronPDF 簡化了複雜的 PDF 任務,對於在 .NET 應用程式中增強文件處理的開發人員來說非常有價值。 無論是建立Web 應用程式、桌面軟體或雲端服務,IronPDF 都能提供專業的 PDF 生成工具。 該庫的功能包括建立、編輯、轉換和保護PDF 文件。
若要下載 PDF 轉換庫,請造訪IronPDF 的 NuGet 套件。 另外,還可以查看IronPDF 的 HTML 轉 PDF 轉換教學。 如需動手實踐,請瀏覽我們的程式碼範例和綜合教學。 IronPDF 開發人員可以根據自身需求選擇不同的許可證。 提供免費試用。 有關完整的定價和許可信息,請訪問IronPDF 許可資訊頁面。 查看更新日誌以取得最新更新和改進資訊。
常見問題解答
如何在C#中將HTML轉換為PDF?
您可以使用 IronPDF 的RenderHtmlAsPdf方法將 HTML 字串轉換為 PDF。您也可以使用RenderHtmlFileAsPdf將 HTML 檔案轉換為 PDF。
在 Visual Studio 專案中設定 IronPDF 需要哪些步驟?
若要在 Visual Studio 專案中安裝 IronPDF,請使用 NuGet 套件管理器搜尋「IronPDF」並安裝最新套件。此過程會將 IronPDF 整合到您的專案中,使您能夠存取其 PDF 功能。
IronPDF在PDF處理上有哪些功能?
IronPDF 提供全面的 PDF 操作功能,包括文字擷取、合併和分割 PDF、旋轉頁面以及修改內容和註釋。
我可以使用 IronPDF 將圖片轉換為 PDF 嗎?
是的,您可以使用 IronPDF 的ImageToPdfConverter方法將影像轉換為 PDF,該方法支援 JPEG、PNG 和 BMP 等影像格式。
IronPDF 如何在 PDF 轉換過程中保持格式?
IronPDF憑藉其強大的渲染引擎,能夠將HTML和影像內容精確地渲染成PDF格式,從而確保在轉換過程中保留原始文件格式。
IronPDF有試用版嗎?
是的,IronPDF 提供免費試用版。有關詳細的定價和許可信息,請參閱 IronPDF 許可資訊頁面。
IronPDF 支援哪些程式語言?
IronPDF 支援與 C#、VB.NET 和 F# 應用程式集成,為在 .NET 生態系統中工作的開發人員提供了廣泛的可能性。
在哪裡可以找到更多關於使用 IronPDF 的教學或支援?
IronPDF 網站和文件頁面提供了更多關於使用 IronPDF 的教學和支持,包括 HTML 到 PDF 轉換和其他功能的指南。
IronPDF 是否完全相容於 .NET 10?
是的-IronPDF 完全相容於 .NET 10,無需任何特殊配置即可無縫運作。它支援 .NET 10 的最新執行時間和語言特性,包括跨平台部署和現代化的非同步友善 API。







