使用 C# .NET 程式庫建立 PDF

我該選擇哪一種安裝方式？

# Use the NuGet package manager to install IronPDF
nuget install IronPdf

# Use the NuGet package manager to install IronPDF
nuget install IronPdf

NuGet 是大多數開發人員推薦的方法，尤其是剛接觸 .NET 開發的開發人員。 它與 Visual Studio 和其他 IDE 無縫集成，非常適合用C# 建立 PDF 。 軟體套件管理器會自動處理所有複雜的配置，包括：

• 依賴關係解析和版本相容性
• 適用於Windows 、 Linux或Mac的特定平台二進位文件
• 透過 Visual Studio 的套件管理器自動更新
• 與專案建置流程集成

常見的安裝問題有哪些？

安裝 IronPDF 時，開發人員有時會遇到一些常見的挑戰。 故障排除指南涵蓋了大多數情況，但以下是最常見的幾種情況：

1.缺少 Visual C++ 執行時間：IronPDF 需要 Visual C++ 可再發行元件。 如果發生缺少 DLL 檔案的錯誤，請從 Microsoft 安裝最新的 Visual C++ 執行階段環境。

2.防火牆阻止 NuGet ：企業環境可能會阻止 NuGet.org。 在這種情況下，您可以下載離線安裝套件並手動安裝。

3.平台不符：確保您的專案面向正確的平台（x86、x64 或 AnyCPU）。 IronPDF 最好是針對特定平台進行最佳化，而不是使用 AnyCPU。

為什麼要使用 NuGet 而不是手動安裝？

對於學習HTML 轉 PDF 的開發人員來說，NuGet 提供了以下幾個優點：

-自動更新：自動取得安全性修補程式和新功能 -版本控制：如有需要，可輕鬆回滾到先前的版本 -團隊協作：所有開發人員都獲得相同的軟體包版本 -建立伺服器相容性：與 CI/CD 管線無縫協作 -軟體包恢復：建置時自動下載缺少的軟體包

NuGet 套件文件提供了針對特定場景（例如Azure 部署或Docker 容器）的進階配置選項。

操作指南

ChromePdfRenderer作用是什麼？

在下面的程式碼中，我們使用 C# 窗體來示範如何使用 C# .NET 程式庫建立 PDF。 在這個例子中，我們有一個TextBox來輸入我們自己的文本，然後點擊一個按鈕即可生成 PDF 文件。 ChromePdfRenderer類別提供了一種最簡單的方法，可以從不同的來源產生 PDF 文件，包括HTML 字串、 Web URL或另一個渲染器下的 doc 文件。

ChromePdfRenderer是 IronPDF 渲染引擎的核心。它採用與 Google Chrome 相同的技術，確保您的 PDF 檔案在現代網頁瀏覽器中的顯示效果與在瀏覽器中完全一致。 這意味著全面支持：

• CSS3樣式和響應式佈局
• 動態內容的JavaScript 執行 -網頁字體和圖標
• SVG圖形
• UTF-8 和國際語言

如何處理PDF產生過程中的錯誤？

錯誤處理對於可靠地產生PDF文件至關重要。 IronPDF 提供詳細的異常訊息，有助於快速識別問題。 以下是一種具有錯誤處理功能的穩健的 PDF 生成方法：

using IronPdf;
using System;
using System.IO;

public class PdfGenerator
{
    public static bool CreatePdfSafely(string htmlContent, string outputPath)
    {
        try
        {
            var renderer = new ChromePdfRenderer();

            // Configure rendering options for better results
            renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.MarginBottom = 20;
            renderer.RenderingOptions.PrintHtmlBackgrounds = true;

            // Generate the PDF
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Ensure directory exists
            string directory = Path.GetDirectoryName(outputPath);
            if (!Directory.Exists(directory))
            {
                Directory.CreateDirectory(directory);
            }

            // Save the PDF
            pdf.SaveAs(outputPath);

            return true;
        }
        catch (Exception ex)
        {
            // Log the error (you can use your preferred logging framework)
            Console.WriteLine($"PDF generation failed: {ex.Message}");
            return false;
        }
    }
}

using IronPdf;
using System;
using System.IO;

public class PdfGenerator
{
    public static bool CreatePdfSafely(string htmlContent, string outputPath)
    {
        try
        {
            var renderer = new ChromePdfRenderer();

            // Configure rendering options for better results
            renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.MarginBottom = 20;
            renderer.RenderingOptions.PrintHtmlBackgrounds = true;

            // Generate the PDF
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Ensure directory exists
            string directory = Path.GetDirectoryName(outputPath);
            if (!Directory.Exists(directory))
            {
                Directory.CreateDirectory(directory);
            }

            // Save the PDF
            pdf.SaveAs(outputPath);

            return true;
        }
        catch (Exception ex)
        {
            // Log the error (you can use your preferred logging framework)
            Console.WriteLine($"PDF generation failed: {ex.Message}");
            return false;
        }
    }
}

對於更進階的錯誤情況，請參閱故障排除指南，其中涵蓋了記憶體管理和渲染延遲等常見問題。

何時應該使用 HTML 渲染，何時應該直接建立 PDF？

了解何時使用 HTML 渲染，何時直接建立 PDF，有助於您選擇正確的方法。 IronPDF 在 HTML 渲染方面表現出色，因為它具備以下優勢：

HTML渲染優勢：

• 利用現有的網站開發技能
• 使用熟悉的 CSS 進行樣式設置
• 易於響應的設計，並帶有視口設置 -支援 JavaScript的動態內容 快速原型製作與迭代

何時使用 HTML 渲染：

• 轉換現有網頁或ASPX 頁面
• 建立具有複雜佈局的報告
• 使用響應式設計
• 根據範本產生發票或收據
• 使用 HTML 表單建立PDF 表單

直接操作 PDF 檔案更適合以下情況：

• 在現有PDF中新增註釋 合併或拆分PDF文件 應用數位簽名 添加浮水印 提取文字和圖像

// C# Program to create PDF from TextBox input using IronPDF
using IronPdf;
using System.Windows.Forms;

namespace readpdf
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        // Event handler for the button click
        private void button1_Click(object sender, System.EventArgs e)
        {
            // Create a ChromePdfRenderer object to convert HTML to PDF
            var HtmlLine = new ChromePdfRenderer();

            // Retrieve the text from the TextBox
            string text = textBox1.Text;

            // Render the HTML as a PDF, wrapping the text in an <h1> tag
            using var pdf = HtmlLine.RenderHtmlAsPdf("<h1>" + text + "</h1>");

            // Save the PDF to a file called "custom.pdf"
            pdf.SaveAs("custom.pdf");

            // Show a confirmation message to the user
            MessageBox.Show("Done!");
        }
    }
}

// C# Program to create PDF from TextBox input using IronPDF
using IronPdf;
using System.Windows.Forms;

namespace readpdf
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        // Event handler for the button click
        private void button1_Click(object sender, System.EventArgs e)
        {
            // Create a ChromePdfRenderer object to convert HTML to PDF
            var HtmlLine = new ChromePdfRenderer();

            // Retrieve the text from the TextBox
            string text = textBox1.Text;

            // Render the HTML as a PDF, wrapping the text in an <h1> tag
            using var pdf = HtmlLine.RenderHtmlAsPdf("<h1>" + text + "</h1>");

            // Save the PDF to a file called "custom.pdf"
            pdf.SaveAs("custom.pdf");

            // Show a confirmation message to the user
            MessageBox.Show("Done!");
        }
    }
}

為什麼這種單擊式方法有效？

點擊方法之所以有效，是因為 IronPDF 在內部處理了所有複雜的渲染。 當您呼叫RenderHtmlAsPdf()時，IronPDF：

1.初始化 Chrome 引擎：使用與 Chrome 瀏覽器相同的渲染引擎 2.處理 HTML ：解析 HTML 字串並套用任何內聯樣式 3.渲染為 PDF ：將渲染後的內容轉換為 PDF 格式 4.最佳化輸出：應用壓縮和最佳化

IronPDF 的簡潔性使其成為需要快速結果的快速開發場景的理想選擇。 該程式庫可自動處理字型管理、映像嵌入，甚至JavaScript 執行。

我可以匯出為哪些文件格式？

雖然 PDF 是主要輸出格式，但 IronPDF 也支援各種匯出和轉換選項：

• PDF 轉影像：將 PDF 檔案轉換為 PNG、JPEG 或 TIFF 格式。
• PDF 轉 HTML ：將 PDF 檔案匯出為 HTML 格式
• PDF/A 合規性：建立用於長期儲存的存檔 PDF 文件
• PDF/UA ：為殘障使用者產生可存取的 PDF 文件 -記憶體流：匯出到記憶體以供 Web 應用程式使用

此外，IronPDF還可以從各種來源匯入資料：

• HTML 檔案和字串 -網址和網頁 DOCX 文件 圖片 Markdown 文件
• RTF 文檔

如何自訂PDF輸出？

IronPDF 透過RenderingOptions類提供豐富的自訂選項。 以下是一個展示常見自訂設定的範例：

using IronPdf;

// Create renderer with custom settings
var renderer = new ChromePdfRenderer();

// Page setup options
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

// Margins (in millimeters)
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

// Header and footer configuration
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    Height = 15,
    HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>",
    DrawDividerLine = true
};

// Additional options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.GrayScale = false;
renderer.RenderingOptions.Zoom = 100;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Generate PDF with all customizations
var pdf = renderer.RenderHtmlAsPdf("<h1>Customized PDF Output</h1>");
pdf.SaveAs("customized.pdf");

using IronPdf;

// Create renderer with custom settings
var renderer = new ChromePdfRenderer();

// Page setup options
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

// Margins (in millimeters)
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

// Header and footer configuration
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    Height = 15,
    HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>",
    DrawDividerLine = true
};

// Additional options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.GrayScale = false;
renderer.RenderingOptions.Zoom = 100;
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Generate PDF with all customizations
var pdf = renderer.RenderHtmlAsPdf("<h1>Customized PDF Output</h1>");
pdf.SaveAs("customized.pdf");

如需更多進階自訂設置，請探索： -自訂紙張尺寸 -頁首和頁尾 背景和前景 頁碼 水印

C# 表單

~ PDF ~

圖書館快速訪問

分享 API 參考

Read through and share the API Reference for all the functionality you need to work with PDFs in your .NET project. The comprehensive documentation covers everything from basic [PDF creation](https://ironpdf.com/tutorials/csharp-create-pdf-complete-tutorial/) to advanced features like [digital signatures](https://ironpdf.com/tutorials/csharp-pdf-security-complete-tutorial/) and [form handling](https://ironpdf.com/how-to/edit-forms/).

IronPDF API 參考