在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。 在這種情況下，您可以下載離線安裝套件並手動安裝。

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

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

ChromePdfRenderer 的作用是什麼？

在下面的程式碼中，我們使用 C# 窗體來示範如何使用 C# .NET程式庫建立 PDF。 在這個例子中，我們可以使用 TextBox 來編寫我們自己的文本，然後點擊一個按鈕即可產生 PDF。 類別 ChromePdfRenderer 提供了一種最簡單的方法，可以從不同的來源產生 PDF 文件，包括HTML 字串、網頁 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 參考