信息圖標
跳過到頁腳內容
  1. IronPdf
  2. IronPdf 部落格
  3. 使用 IronPdf
  4. 動態 PDF 生成 C#
USING IRONPDF

Dynamic PDF Generation in C#: Complete Implementation Guide

Curtis Chau
Curtis Chau
更新:

IronPDF 允許使用基於 Chrome 的渲染技術在執行時將 HTML 內容轉換為 PDF，從而在 C# 中動態建立 PDF。 這使得 .NET 應用程式能夠建立包含來自資料庫、API 或使用者輸入的可變資料的個人化文檔，用於發票、報告和表單。

現代Web應用程式需要的不僅僅是建立靜態文件。 無論是產生個人化發票、建立資料驅動的 PDF 報告，還是產生自訂表單字段，都需要可靠的工具在運行時產生 PDF 文件。 IronPDF 是一款領先的解決方案，它提供高效的基於 Chrome 的渲染功能，可建立 PDF 文檔，並與 C# 無縫集成，從而在.NET Framework環境中實現動態 PDF 生成。

IronPDF C# PDF 庫的宣傳橫幅展示了其主要功能：HTML 轉 PDF、PDF 編輯 API、雲端部署選項和免費試用。

C#中的動態PDF生成是什麼？

C# 中的動態 PDF 產生涉及在執行時使用來自資料庫、API 或使用者輸入的可變資料建立 PDF 文件。 與靜態 PDF 檔案不同，運行時產生允許個性化內容、條件部分和資料驅動佈局。 這些功能對於發票、 PDF 報告、證書和表格等適應不斷變化的需求至關重要。 這種方法對於現代的.NET Framework和.NET Core應用程式來說至關重要。 IronPDF 文件提供了在C# 應用程式中實現這些功能的完整指南。

IronPDF 跨平台相容性圖表，展示了對多種 .NET 版本、程式語言、作業系統和部署環境（包括雲端平台）的支援。

何時應該使用動態PDF生成？

當您的應用程式需要根據使用者資料或業務邏輯變更個人化文件時，動態 PDF 生成至關重要。 常見情境包括產生具有自動資料更新的月度報告、建立包含客戶特定資訊的發票、產生帶有唯一收件人姓名的證書以及建立根據使用者個人資料預先填入的表單。 如果您的內容會隨著每個請求而變化，或者需要即時資料集成，那麼動態生成比靜態模板更有效。 考慮使用IronPDF 的非同步處理功能來處理大量數據，並探索企業應用程式的效能最佳化技術。

動態 PDF 與靜態 PDF 有什麼不同？

靜態 PDF 建立後保持不變，類似於以數位方式保存的傳統紙本文件。 動態 PDF 每次被要求時都會產生新的內容，這些內容來自即時資料來源。 例如，靜態產品目錄需要手動更新和重新分發，而動態目錄則自動包含最新的價格、庫存水準和產品描述。 動態 PDF 還可以包含互動式元素、條件內容以及基於使用者偏好或權限的個人化佈局。 了解更多關於PDF元資料管理和安全功能的信息，以改善您的動態文件。

哪些產業最能從動態 PDF 生成中受益？

金融服務業使用動態 PDF 來產生帳戶報表、貸款文件和監管報告，這些都需要即時準確性。 醫療機構產生符合HIPAA 標準的病人記錄、化驗結果和保險表格。 電子商務平台產生訂單確認函、出貨標籤和退貨授權書。 教育機構開立成績單、證書和個人化學習資料。 政府機構透過自動產生簡化許可證申請、稅務表格和合規文件。 IronPDF 的示範展示了這些行業的實際應用。

如何開始使用 IronPDF？

首先透過 Visual Studio 中的套件管理器控制台安裝IronPDF NuGet 套件：

Install-Package IronPdf
Install-Package IronPdf
SHELL

! 程式包管理器控制台視窗顯示 IronPDF NuGet 套件的安裝過程，包括多個相依性的下載及其檔案大小。

或使用NuGet 套件管理器介面下載並安裝。 初始化ChromePdfRenderer以產生像素級精確的 PDF 檔案：

using IronPdf;
// Create Chrome renderer instance
var renderer = new ChromePdfRenderer();
// Configure rendering options for PDF format
renderer.RenderingOptions.MarginTop = 50;
renderer.RenderingOptions.MarginBottom = 50;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
using IronPdf;
// Create Chrome renderer instance
var renderer = new ChromePdfRenderer();
// Configure rendering options for PDF format
renderer.RenderingOptions.MarginTop = 50;
renderer.RenderingOptions.MarginBottom = 50;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Imports IronPdf

' Create Chrome renderer instance
Dim renderer As New ChromePdfRenderer()

' Configure rendering options for PDF format
renderer.RenderingOptions.MarginTop = 50
renderer.RenderingOptions.MarginBottom = 50
renderer.RenderingOptions.PrintHtmlBackgrounds = True
$vbLabelText   $csharpLabel

ChromePdfRenderer類別為運行時產生 PDF 提供了基礎。設定邊距可確保頁首和頁尾的空間，而PrintHtmlBackgrounds則可保留設計元素。 此配置有助於根據 HTML 內容精確建立 PDF 文件。 了解更多有關自訂 PDF 文件的渲染選項，包括自訂紙張尺寸和頁面方向。

IronPDF 的系統需求是什麼？

IronPDF 支援Windows 、 Linux和macOS環境，需要.NET Framework 4.6.2+或.NET Core 3.1+ 。 對於Windows 部署，請確保已安裝 Visual C++ 執行階段。 Linux 系統需要 libgdiplus 和其他相依性。 Docker容器需要包含圖形庫的特定基礎映像。 Azure等雲端平台需要 B1 層或更高層級，而AWS Lambda函數需要自訂執行時間。 請查閱安裝指南，以了解特定平台的要求和故障排除技巧。 對於有軟體包大小限制的環境，請考慮使用IronPdf.Slim 。

如何配置ChromePdfRenderer以獲得最佳效果？

透過以下基本設定改進渲染器：

var renderer = new ChromePdfRenderer();

// Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

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

// Enable JavaScript execution
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 500; // milliseconds

// Set custom CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Configure image quality
renderer.RenderingOptions.ImageQuality = 90;
var renderer = new ChromePdfRenderer();

// Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;

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

// Enable JavaScript execution
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.RenderDelay = 500; // milliseconds

// Set custom CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Configure image quality
renderer.RenderingOptions.ImageQuality = 90;
Dim renderer = New ChromePdfRenderer()

' Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait

' Configure margins (in millimeters)
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20

' Enable JavaScript execution
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.RenderDelay = 500 ' milliseconds

' Set custom CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print

' Configure image quality
renderer.RenderingOptions.ImageQuality = 90
$vbLabelText   $csharpLabel

RenderDelay允許 JavaScript 在渲染之前完成執行。 CSS 媒體類型選擇可確保套用列印增強樣式。 影像品質設定用於平衡檔案大小和視覺保真度。 探索進階渲染選項，以滿足自訂紙張尺寸或視窗設定等特殊需求。 了解JavaScript 渲染動態內容和字體管理，以實現排版控制。

安裝過程中應該注意哪些常見問題？

大多數安裝問題都是由缺少依賴項引起的。 在 Windows 系統上，安裝Visual C++ Redistributables 。 Linux 使用者必須安裝libgdiplus 和字型軟體套件。 Docker部署需要具有圖形支援的特定基礎映像。 需要停用Azure Functions 的使用計畫。 檢查防火牆設定以驗證許可證。 查看常見故障排除場景並啟用日誌記錄以進行詳細診斷。 請參考IronPDF 針對生產環境部署的安全最佳實務。

如何使用範本動態建立 PDF 文件？

建立具有佔位符的可重複使用 HTML 模板，用於動態資料注入：

// Define HTML string template with placeholders
string invoiceTemplate = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        .header { background-color: #f0f0f0; padding: 20px; }
        table { width: 100%; border-collapse: collapse; }
        th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
    </style>
</head>
<body>
    <div class='header'>
        <h1>Invoice #[[INVOICE_NUMBER]]</h1>
        <p>Date: [[DATE]]</p>
        <p>Customer: [[CUSTOMER_NAME]]</p>
    </div>
    <table>
        <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
        [[ITEMS]]
    </table>
    <p><strong>Total: $[[TOTAL]]</strong></p>
</body>
</html>";

// Replace placeholders with dynamic data
var invoiceData = new {
    InvoiceNumber = "INV-2025-001",
    Date = DateTime.Now.ToString("yyyy-MM-dd"),
    CustomerName = "John Doe",
    Total = 1250.00m
};

// Build items dynamically
var itemsHtml = new StringBuilder();
itemsHtml.Append("<tr><td>Web Development</td><td>40 hours</td><td>$1000.00</td></tr>");
itemsHtml.Append("<tr><td>Design Services</td><td>10 hours</td><td>$250.00</td></tr>");

string finalHtml = invoiceTemplate
    .Replace("[[INVOICE_NUMBER]]", invoiceData.InvoiceNumber)
    .Replace("[[DATE]]", invoiceData.Date)
    .Replace("[[CUSTOMER_NAME]]", invoiceData.CustomerName)
    .Replace("[[ITEMS]]", itemsHtml.ToString())
    .Replace("[[TOTAL]]", invoiceData.Total.ToString());

// Generate PDF from populated HTML content
var PDF = renderer.RenderHtmlAsPdf(finalHtml);
PDF.SaveAs("invoice.pdf");
// Define HTML string template with placeholders
string invoiceTemplate = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        .header { background-color: #f0f0f0; padding: 20px; }
        table { width: 100%; border-collapse: collapse; }
        th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
    </style>
</head>
<body>
    <div class='header'>
        <h1>Invoice #[[INVOICE_NUMBER]]</h1>
        <p>Date: [[DATE]]</p>
        <p>Customer: [[CUSTOMER_NAME]]</p>
    </div>
    <table>
        <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
        [[ITEMS]]
    </table>
    <p><strong>Total: $[[TOTAL]]</strong></p>
</body>
</html>";

// Replace placeholders with dynamic data
var invoiceData = new {
    InvoiceNumber = "INV-2025-001",
    Date = DateTime.Now.ToString("yyyy-MM-dd"),
    CustomerName = "John Doe",
    Total = 1250.00m
};

// Build items dynamically
var itemsHtml = new StringBuilder();
itemsHtml.Append("<tr><td>Web Development</td><td>40 hours</td><td>$1000.00</td></tr>");
itemsHtml.Append("<tr><td>Design Services</td><td>10 hours</td><td>$250.00</td></tr>");

string finalHtml = invoiceTemplate
    .Replace("[[INVOICE_NUMBER]]", invoiceData.InvoiceNumber)
    .Replace("[[DATE]]", invoiceData.Date)
    .Replace("[[CUSTOMER_NAME]]", invoiceData.CustomerName)
    .Replace("[[ITEMS]]", itemsHtml.ToString())
    .Replace("[[TOTAL]]", invoiceData.Total.ToString());

// Generate PDF from populated HTML content
var PDF = renderer.RenderHtmlAsPdf(finalHtml);
PDF.SaveAs("invoice.pdf");
' Define HTML string template with placeholders
Dim invoiceTemplate As String = "
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        .header { background-color: #f0f0f0; padding: 20px; }
        table { width: 100%; border-collapse: collapse; }
        th, td { padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
    </style>
</head>
<body>
    <div class='header'>
        <h1>Invoice #[[INVOICE_NUMBER]]</h1>
        <p>Date: [[DATE]]</p>
        <p>Customer: [[CUSTOMER_NAME]]</p>
    </div>
    <table>
        <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
        [[ITEMS]]
    </table>
    <p><strong>Total: $[[TOTAL]]</strong></p>
</body>
</html>"

' Replace placeholders with dynamic data
Dim invoiceData = New With {
    .InvoiceNumber = "INV-2025-001",
    .Date = DateTime.Now.ToString("yyyy-MM-dd"),
    .CustomerName = "John Doe",
    .Total = 1250.0D
}

' Build items dynamically
Dim itemsHtml = New StringBuilder()
itemsHtml.Append("<tr><td>Web Development</td><td>40 hours</td><td>$1000.00</td></tr>")
itemsHtml.Append("<tr><td>Design Services</td><td>10 hours</td><td>$250.00</td></tr>")

Dim finalHtml As String = invoiceTemplate _
    .Replace("[[INVOICE_NUMBER]]", invoiceData.InvoiceNumber) _
    .Replace("[[DATE]]", invoiceData.Date) _
    .Replace("[[CUSTOMER_NAME]]", invoiceData.CustomerName) _
    .Replace("[[ITEMS]]", itemsHtml.ToString()) _
    .Replace("[[TOTAL]]", invoiceData.Total.ToString())

' Generate PDF from populated HTML content
Dim PDF = renderer.RenderHtmlAsPdf(finalHtml)
PDF.SaveAs("invoice.pdf")
$vbLabelText   $csharpLabel

這種模板方法將展示與資料分離，使設計人員能夠修改複雜的佈局，而開發人員則專注於資料整合。 Replace 方法會將佔位符替換為執行時間值，從而建立個人化的 PDF 文件。 對於包含重複部分的 HTML 內容轉換，請在進行 PDF 轉換之前使用循環動態建立 HTML。 探索更多HTML 轉 PDF 範例，了解包括CSS 樣式和JavaScript 整合在內的高階模板技術。 考慮將HTML檔案轉換為PDF格式，以便進行外部範本管理。

輸出

PDF 檢視器顯示編號為 INV-2025-001 的已產生發票，其中包含客戶詳細資料和總計 1250.00 美元，並附有 Iron Software 浮水印。

為什麼要使用基於模板的 PDF 生成？

基於範本的產生將業務邏輯與表現形式分離，從而實現並行開發工作流程。 設計師可以使用熟悉的工具來完善HTML 佈局，而開發人員則可以實現資料綁定。 模板支援版本控制、A/B 測試和本地化，無需更改程式碼。 可重複使用的組件減少了重複工作和維護成本。 CSS 媒體查詢確保響應式設計完美轉換為 PDF 輸出。 這種方法可以從簡單的信件擴展到複雜的多頁報告，並保持一致的品牌形象。 了解背景和前景元素以改善視覺設計，並探索滿足品牌需求的加水印技術。

如何在模板中處理複雜的資料結構？

在模板注入之前，透過程式設計方式建立 HTML 部分來處理分層資料。 使用LINQ 查詢將集合轉換為 HTML 表格或清單。 使用 if 語句實現條件渲染，以包含或排除模板部分。 對於嵌套數據，建立遞歸建構內容的子範本。 考慮在模板中使用Razor 語法來編寫複雜的邏輯。 JSON 序列化能夠將結構化資料傳遞給JavaScript-improve 範本。 建立輔助方法，將領域物件轉換為 HTML 片段，以實現更清晰的程式碼組織。 探索如何產生目錄以組織複雜文件。

模板佔位符設計的最佳實踐是什麼？

選擇不會與 HTML 或 CSS 衝突的獨特佔位符語法，例如[[FIELD_NAME]]或{{field}} 。 使用能夠表明資料類型和格式要求的描述性名稱。 將相關佔位符號分組，並新增前綴（ CUSTOMER_NAME 、 CUSTOMER_EMAIL ）。 記錄可用的佔位符及其資料來源，供團隊參考。 為可選欄位實作備用值，以防止渲染錯誤。 考慮對使用者產生的內容使用HTML 編碼，以防止注入攻擊。 建立範本驗證方法，以驗證所有佔位符是否具有對應的資料值。 檢查基本 URL 配置，確保範本中的資源載入正確。 ## 如何使用非同步處理擴充 PDF 生成？

使用非同步方法擴展 PDF 生成能力，以應對大批量處理：

// Async batch generation for multiple PDF documents
public async Task GenerateMonthlyReportsAsync(List<Customer> customers)
{
    var renderer = new ChromePdfRenderer();

    // Configure for batch processing
    renderer.RenderingOptions.EnableJavaScript = false; // Faster without JS
    renderer.RenderingOptions.RenderDelay = 0; // No delay needed

    var semaphore = new SemaphoreSlim(5); // Limit concurrent operations
    var tasks = new List<Task>();

    foreach (var customer in customers)
    {
        tasks.Add(Task.Run(async () =>
        {
            await semaphore.WaitAsync();
            try
            {
                // Create HTML content with dynamic data
                string HTML = $@"
                    <html>
                    <head>
                        <style>
                            body {{ font-family: Arial; margin: 40px; }}
                            .header {{ color: #333; border-bottom: 2px solid #4CAF50; }}
                            .metrics {{ margin: 20px 0; }}
                            .metric-box {{ 
                                display: inline-block; 
                                padding: 20px; 
                                margin: 10px;
                                background: #f5f5f5;
                                border-radius: 5px;
                            }}
                        </style>
                    </head>
                    <body>
                        <div class='header'>
                            <h2>Monthly Report - {customer.Name}</h2>
                            <p>Report Period: {DateTime.Now:MMMM yyyy}</p>
                        </div>
                        <div class='metrics'>
                            <div class='metric-box'>
                                <h3>Account Balance</h3>
                                <p style='font-size: 24px; color: #4CAF50;'>${customer.Balance:F2}</p>
                            </div>
                            <div class='metric-box'>
                                <h3>Total Transactions</h3>
                                <p style='font-size: 24px; color: #2196F3;'>{customer.TransactionCount}</p>
                            </div>
                        </div>
                        <div style='page-break-after: always;'></div>
                    </body>
                    </html>";

                // Convert HTML to PDF format
                var document = await renderer.RenderHtmlAsPdfAsync(HTML);

                // Add metadata
                document.MetaData.Author = "Reporting System";
                document.MetaData.Title = $"Monthly Report - {customer.Name}";
                document.MetaData.CreationDate = DateTime.Now;

                await document.SaveAs($"reports/{customer.Id}_report_{DateTime.Now:yyyyMM}.pdf");
            }
            finally
            {
                semaphore.Release();
            }
        }));
    }

    await Task.WhenAll(tasks);
}
// Async batch generation for multiple PDF documents
public async Task GenerateMonthlyReportsAsync(List<Customer> customers)
{
    var renderer = new ChromePdfRenderer();

    // Configure for batch processing
    renderer.RenderingOptions.EnableJavaScript = false; // Faster without JS
    renderer.RenderingOptions.RenderDelay = 0; // No delay needed

    var semaphore = new SemaphoreSlim(5); // Limit concurrent operations
    var tasks = new List<Task>();

    foreach (var customer in customers)
    {
        tasks.Add(Task.Run(async () =>
        {
            await semaphore.WaitAsync();
            try
            {
                // Create HTML content with dynamic data
                string HTML = $@"
                    <html>
                    <head>
                        <style>
                            body {{ font-family: Arial; margin: 40px; }}
                            .header {{ color: #333; border-bottom: 2px solid #4CAF50; }}
                            .metrics {{ margin: 20px 0; }}
                            .metric-box {{ 
                                display: inline-block; 
                                padding: 20px; 
                                margin: 10px;
                                background: #f5f5f5;
                                border-radius: 5px;
                            }}
                        </style>
                    </head>
                    <body>
                        <div class='header'>
                            <h2>Monthly Report - {customer.Name}</h2>
                            <p>Report Period: {DateTime.Now:MMMM yyyy}</p>
                        </div>
                        <div class='metrics'>
                            <div class='metric-box'>
                                <h3>Account Balance</h3>
                                <p style='font-size: 24px; color: #4CAF50;'>${customer.Balance:F2}</p>
                            </div>
                            <div class='metric-box'>
                                <h3>Total Transactions</h3>
                                <p style='font-size: 24px; color: #2196F3;'>{customer.TransactionCount}</p>
                            </div>
                        </div>
                        <div style='page-break-after: always;'></div>
                    </body>
                    </html>";

                // Convert HTML to PDF format
                var document = await renderer.RenderHtmlAsPdfAsync(HTML);

                // Add metadata
                document.MetaData.Author = "Reporting System";
                document.MetaData.Title = $"Monthly Report - {customer.Name}";
                document.MetaData.CreationDate = DateTime.Now;

                await document.SaveAs($"reports/{customer.Id}_report_{DateTime.Now:yyyyMM}.pdf");
            }
            finally
            {
                semaphore.Release();
            }
        }));
    }

    await Task.WhenAll(tasks);
}
Imports System
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

' Async batch generation for multiple PDF documents
Public Class ReportGenerator
    Public Async Function GenerateMonthlyReportsAsync(customers As List(Of Customer)) As Task
        Dim renderer = New ChromePdfRenderer()

        ' Configure for batch processing
        renderer.RenderingOptions.EnableJavaScript = False ' Faster without JS
        renderer.RenderingOptions.RenderDelay = 0 ' No delay needed

        Dim semaphore = New SemaphoreSlim(5) ' Limit concurrent operations
        Dim tasks = New List(Of Task)()

        For Each customer In customers
            tasks.Add(Task.Run(Async Function()
                                   Await semaphore.WaitAsync()
                                   Try
                                       ' Create HTML content with dynamic data
                                       Dim HTML As String = $"
                    <html>
                    <head>
                        <style>
                            body {{ font-family: Arial; margin: 40px; }}
                            .header {{ color: #333; border-bottom: 2px solid #4CAF50; }}
                            .metrics {{ margin: 20px 0; }}
                            .metric-box {{ 
                                display: inline-block; 
                                padding: 20px; 
                                margin: 10px;
                                background: #f5f5f5;
                                border-radius: 5px;
                            }}
                        </style>
                    </head>
                    <body>
                        <div class='header'>
                            <h2>Monthly Report - {customer.Name}</h2>
                            <p>Report Period: {DateTime.Now:MMMM yyyy}</p>
                        </div>
                        <div class='metrics'>
                            <div class='metric-box'>
                                <h3>Account Balance</h3>
                                <p style='font-size: 24px; color: #4CAF50;'>${customer.Balance:F2}</p>
                            </div>
                            <div class='metric-box'>
                                <h3>Total Transactions</h3>
                                <p style='font-size: 24px; color: #2196F3;'>{customer.TransactionCount}</p>
                            </div>
                        </div>
                        <div style='page-break-after: always;'></div>
                    </body>
                    </html>"

                                       ' Convert HTML to PDF format
                                       Dim document = Await renderer.RenderHtmlAsPdfAsync(HTML)

                                       ' Add metadata
                                       document.MetaData.Author = "Reporting System"
                                       document.MetaData.Title = $"Monthly Report - {customer.Name}"
                                       document.MetaData.CreationDate = DateTime.Now

                                       Await document.SaveAs($"reports/{customer.Id}_report_{DateTime.Now:yyyyMM}.pdf")
                                   Finally
                                       semaphore.Release()
                                   End Try
                               End Function))
        Next

        Await Task.WhenAll(tasks)
    End Function
End Class

Public Class Customer
    Public Property Name As String
    Public Property Balance As Decimal
    Public Property TransactionCount As Integer
    Public Property Id As Integer
End Class

Public Class ChromePdfRenderer
    Public Property RenderingOptions As New RenderingOptions()

    Public Async Function RenderHtmlAsPdfAsync(html As String) As Task(Of PdfDocument)
        ' Simulated async PDF rendering
        Return Await Task.FromResult(New PdfDocument())
    End Function
End Class

Public Class RenderingOptions
    Public Property EnableJavaScript As Boolean
    Public Property RenderDelay As Integer
End Class

Public Class PdfDocument
    Public Property MetaData As New PdfMetaData()

    Public Async Function SaveAs(filePath As String) As Task
        ' Simulated async save
        Await Task.CompletedTask
    End Function
End Class

Public Class PdfMetaData
    Public Property Author As String
    Public Property Title As String
    Public Property CreationDate As DateTime
End Class
$vbLabelText   $csharpLabel

非同步模式支援並發生成 PDF，從而顯著提高批量生成 PDF 文件時的吞吐量。 任務WhenAll確保所有 PDF 檔案都已完整後再繼續執行。 程式碼使用CSS 分頁屬性來控制分頁，確保每位客戶的報告都從新的一頁開始。 SemaphoreSlim透過限制並發操作來防止記憶體耗盡。 檢視企業 Web 應用程式的非同步 PDF 產生文檔，包括平行處理策略。 對於 CPU 密集型工作負載，可考慮採用多執行緒產生。

何時應該使用非同步PDF生成？

非同步處理非常適合 Web 應用程序，因為阻塞操作會影響使用者體驗。 當同時產生多個文件、處理大型 HTML 檔案或與速度較慢的外部 API 整合時，請使用非同步方法。後台服務可以利用非同步模式來產生計劃報告。 Webhook 處理程序可以處理請求而不會逾時。 利用並行處理可以更快地完成批量操作，例如每月開票。 然而，簡單的單一文件生成可能不會從增加的複雜性中受益。 探索非同步實作範例，了解各種實作模式。

如何處理批次過程中的記憶體使用情況？

實施 資源處置模式，以便及時釋放資源。 對於臨時存儲，請使用內存流而不是檔案操作。 配置伺服器工作負載的垃圾回收機制。 使用SemaphoreSlim或類似的限流機制限制並發操作。 使用效能計數器監控記憶體使用情況。 考慮將大型資料集分成較小的批次。 壓縮輸出的PDF檔案以減少儲存需求。 查看效能最佳化指南，了解更多策略，包括針對網路交付的線性化。

應該監控哪些效能指標？

追蹤每個文件的 PDF 產生時間，以找出瓶頸。 監控高峰負載期間的記憶體消耗情況。 測量渲染操作中的 CPU 使用率。 記錄失敗的生成過程及其錯誤詳情，以便進行故障排除。 吞吐量以每分鐘文檔數計算。 監控磁碟 I/O以發現儲存瓶頸。 監控渲染外部URL時的網路延遲。 設定渲染逾時或記憶體壓力警報。 使用自訂日誌記錄來擷取詳細指標。 在您的 PDF 生成流程中實施效能監控。

如何動態建立互動式PDF表單？

透過程式設計方式將包含 HTML 表單的網頁轉換為可填寫的 PDF 檔案：

// Enable form fields creation in rendering options
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Define HTML string with form elements
string formHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        form { background: #f9f9f9; padding: 30px; border-radius: 8px; }
        h2 { color: #333; margin-bottom: 20px; }
        label { display: block; margin: 15px 0 5px; font-weight: bold; }
        input[type='text'], input[type='email'], textarea, select {
            width: 100%;
            padding: 10px;
            border: 1px solid #ddd;
            border-radius: 4px;
            box-sizing: border-box;
        }
        textarea { height: 100px; resize: vertical; }
        input[type='checkbox'] { margin-right: 8px; }
        .checkbox-group { margin: 15px 0; }
        button { 
            background: #4CAF50; 
            color: white; 
            padding: 12px 24px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
            margin-top: 20px;
        }
    </style>
</head>
<body>
    <form>
        <h2>Customer Survey Form</h2>

        <label for='name'>Full Name:</label>
        <input type='text' id='name' name='name' required>

        <label for='email'>Email Address:</label>
        <input type='email' id='email' name='email' required>

        <label for='satisfaction'>Overall Satisfaction:</label>
        <select id='satisfaction' name='satisfaction'>
            <option value=''>Please select...</option>
            <option value='excellent'>Excellent</option>
            <option value='good'>Good</option>
            <option value='fair'>Fair</option>
            <option value='poor'>Poor</option>
        </select>

        <div class='checkbox-group'>
            <label>Services Used:</label>
            <label><input type='checkbox' name='services' value='support'> Technical Support</label>
            <label><input type='checkbox' name='services' value='training'> Training</label>
            <label><input type='checkbox' name='services' value='consulting'> Consulting</label>
        </div>

        <label for='comments'>Additional Comments:</label>
        <textarea id='comments' name='comments' placeholder='Share your feedback...'></textarea>

        <button type='submit'>Submit Survey</button>
    </form>
</body>
</html>";

// Create a PDF with interactive form fields
var pdfDocument = renderer.RenderHtmlAsPdf(formHtml);

// Optional: Set form field properties programmatically
var formManager = pdfDocument.Form;
formManager.FindField("name").Value = ""; // Pre-populate if needed
formManager.FindField("email").Required = true;

// Save the interactive PDF
pdfDocument.SaveAs("customer_survey_form.pdf");
// Enable form fields creation in rendering options
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// Define HTML string with form elements
string formHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        form { background: #f9f9f9; padding: 30px; border-radius: 8px; }
        h2 { color: #333; margin-bottom: 20px; }
        label { display: block; margin: 15px 0 5px; font-weight: bold; }
        input[type='text'], input[type='email'], textarea, select {
            width: 100%;
            padding: 10px;
            border: 1px solid #ddd;
            border-radius: 4px;
            box-sizing: border-box;
        }
        textarea { height: 100px; resize: vertical; }
        input[type='checkbox'] { margin-right: 8px; }
        .checkbox-group { margin: 15px 0; }
        button { 
            background: #4CAF50; 
            color: white; 
            padding: 12px 24px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
            margin-top: 20px;
        }
    </style>
</head>
<body>
    <form>
        <h2>Customer Survey Form</h2>

        <label for='name'>Full Name:</label>
        <input type='text' id='name' name='name' required>

        <label for='email'>Email Address:</label>
        <input type='email' id='email' name='email' required>

        <label for='satisfaction'>Overall Satisfaction:</label>
        <select id='satisfaction' name='satisfaction'>
            <option value=''>Please select...</option>
            <option value='excellent'>Excellent</option>
            <option value='good'>Good</option>
            <option value='fair'>Fair</option>
            <option value='poor'>Poor</option>
        </select>

        <div class='checkbox-group'>
            <label>Services Used:</label>
            <label><input type='checkbox' name='services' value='support'> Technical Support</label>
            <label><input type='checkbox' name='services' value='training'> Training</label>
            <label><input type='checkbox' name='services' value='consulting'> Consulting</label>
        </div>

        <label for='comments'>Additional Comments:</label>
        <textarea id='comments' name='comments' placeholder='Share your feedback...'></textarea>

        <button type='submit'>Submit Survey</button>
    </form>
</body>
</html>";

// Create a PDF with interactive form fields
var pdfDocument = renderer.RenderHtmlAsPdf(formHtml);

// Optional: Set form field properties programmatically
var formManager = pdfDocument.Form;
formManager.FindField("name").Value = ""; // Pre-populate if needed
formManager.FindField("email").Required = true;

// Save the interactive PDF
pdfDocument.SaveAs("customer_survey_form.pdf");
Imports IronPdf

' Enable form fields creation in rendering options
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

' Define HTML string with form elements
Dim formHtml As String = "
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        form { background: #f9f9f9; padding: 30px; border-radius: 8px; }
        h2 { color: #333; margin-bottom: 20px; }
        label { display: block; margin: 15px 0 5px; font-weight: bold; }
        input[type='text'], input[type='email'], textarea, select {
            width: 100%;
            padding: 10px;
            border: 1px solid #ddd;
            border-radius: 4px;
            box-sizing: border-box;
        }
        textarea { height: 100px; resize: vertical; }
        input[type='checkbox'] { margin-right: 8px; }
        .checkbox-group { margin: 15px 0; }
        button { 
            background: #4CAF50; 
            color: white; 
            padding: 12px 24px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
            margin-top: 20px;
        }
    </style>
</head>
<body>
    <form>
        <h2>Customer Survey Form</h2>

        <label for='name'>Full Name:</label>
        <input type='text' id='name' name='name' required>

        <label for='email'>Email Address:</label>
        <input type='email' id='email' name='email' required>

        <label for='satisfaction'>Overall Satisfaction:</label>
        <select id='satisfaction' name='satisfaction'>
            <option value=''>Please select...</option>
            <option value='excellent'>Excellent</option>
            <option value='good'>Good</option>
            <option value='fair'>Fair</option>
            <option value='poor'>Poor</option>
        </select>

        <div class='checkbox-group'>
            <label>Services Used:</label>
            <label><input type='checkbox' name='services' value='support'> Technical Support</label>
            <label><input type='checkbox' name='services' value='training'> Training</label>
            <label><input type='checkbox' name='services' value='consulting'> Consulting</label>
        </div>

        <label for='comments'>Additional Comments:</label>
        <textarea id='comments' name='comments' placeholder='Share your feedback...'></textarea>

        <button type='submit'>Submit Survey</button>
    </form>
</body>
</html>"

' Create a PDF with interactive form fields
Dim pdfDocument = renderer.RenderHtmlAsPdf(formHtml)

' Optional: Set form field properties programmatically
Dim formManager = pdfDocument.Form
formManager.FindField("name").Value = "" ' Pre-populate if needed
formManager.FindField("email").Required = True

' Save the interactive PDF
pdfDocument.SaveAs("customer_survey_form.pdf")
$vbLabelText   $csharpLabel

設定CreatePdfFormsFromHtml會將 HTML 表單元素轉換為互動式 PDF 表單欄位。 使用者可以電子方式填寫、儲存和提交這些PDF文件。 此功能透過消除紙本表格簡化了工作流程，同時保持了熟悉的 HTML 開發模式。 PDFDocument 物件提供了以程式設計方式操作表單欄位的功能。 了解PDF 表單操作的進階實作方式，包括數位簽章。 瀏覽表單資料範例，了解其實際應用。

輸出

PDF 檢視器中顯示一份客戶調查表，包含姓名、電子郵件、滿意度下拉式選單（設定為"優良"）和評論欄等字段，並附有 Iron Software 浮水印。

支援哪些HTML表單元素？

IronPDF 支援所有標準 HTML 表單元素，包括文字輸入框、文字區域、複選框、單選按鈕、下拉選擇框和按鈕。 密碼欄位將轉換為安全文字輸入。 檔案上傳輸入框會變成附件佔位符。 隱藏欄位會保留表單資料但不顯示。 HTML5 輸入類型（如電子郵件、電話和號碼）都維護驗證規則。 自訂樣式適用於表單外觀。 查看表單文檔，以了解元素的具體行為和限制。 考慮表單合規性的無障礙功能。

如何驗證PDF表單資料？

在產生PDF之前，使用JavaScript實作客戶端驗證。 設定表單欄位的必填屬性以啟用內建驗證。 使用正規表示式對文字輸入進行模式比對。 配置數字欄位的數值範圍。 使用 Acrobat JavaScript 為 PDF 表單新增自訂驗證腳本。 在處理提交的表單時，實作伺服器端驗證。 考慮使用數位簽章來防止提交內容被竄改。 建立能夠清晰顯示錯誤的驗證摘要。 探索JavaScript 訊息監聽器，用於進階驗證場景。

能否動態預填表單欄位？

渲染完成後，可透過Form 屬性存取表單欄位。 使用FindField ("fieldName").Value 設定欄位值。 從資料庫或 API 回應中取得資料。 實現使用者資料集成，實現自動填寫。 建立帶有預設值的模板。 支援批量生成表單，每個PDF文件包含唯一資料。 啟用表單欄位計算功能，用於計算值。 考慮預填敏感資料所帶來的安全隱患。 了解複雜場景下的表單欄位管理。

為什麼選擇 IronPDF 而不是其他 PDF 庫？

授權許可起價為$799適用於單一開發者），另有團隊和企業選項可供選擇。 每個軟體包都具有獨特的優勢，並且透過節省開發時間，投資即可收回成本。 購買後即可立即取得您的 API 金鑰。 查看授權選項，找到適合您專案的 NuGet 套件。

IronPDF 的Chrome 渲染引擎可確保在建立 PDF 時達到像素級的精確度，消除了舊版WebKit 渲染引擎解決方案的妥協。 與需要外部可執行檔或無頭瀏覽器設定的開源替代方案不同，IronPDF 可以無縫集成，無需任何依賴項。 流暢的 API 和高級設計使其優於內建類別或複雜的 Crystal Reports 實作。 將IronPDF 與競爭對手進行比較，以了解其優勢。

IronPDF 功能概覽，包含四大類功能：建立 PDF、轉換 PDF、編輯 PDF 以及簽名和保護 PDF，每類功能下都有詳細的功能列表，背景為深紫色。

IronPDF在動態PDF生成方面的主要優勢是什麼？

進階功能包括浮水印、數位簽章、表單建立、 PDF/A 合規性和加密。 .NET 整合支援從控制台應用程式到Azure Functions 的所有專案類型。 跨平台相容性確保在Windows 、 Linux和macOS上獲得一致的結果。 性能優化能夠高效處理企業級發電。 探索IronPDF 的各項功能，了解其全部特性。

IronPDF 功能概述展示了三大主要優勢：基於 Chromium 等級 HTML/CSS/JS 的像素級完美渲染、透過套件管理器 5 分鐘即可完成安裝，以及跨平台相容於 Windows、Linux、macOS 和雲端服務。

IronPDF 與免費替代方案相比如何？

免費庫通常缺乏商業支持，而這對於生產應用至關重要。 IronPDF 提供24/5 全天候技術支持，並配備專門的工程師。 開源替代方案可能存在與商業用途不相容的授權限制。 IronPDF 為各種使用情境提供靈活的許可模式。 效能基準測試表明，IronPDF 產生 PDF 的速度比 wkhtmltopdf快 3-5 倍。 Chrome渲染引擎相比老舊的引擎，能夠產生更出色的輸出效果。 定期更新可確保與最新的網路標準相容。 查閱詳細的競爭對手比較資料，以了解具體的替代方案。

IronPDF有哪些值得投資的理由？

透過節省開發時間計算投資回報率——開發人員報告稱，與替代方案相比，實施速度提高了 40% 。 透過託管依賴項和自動更新消除維護開銷。 在競爭產品中， HSM簽名和PDF/UA合規性等企業級功能售價高達數千美元。 免版稅分發免除了按文件計費的費用。 完善的文件和程式碼範例降低了學習難度。 跨平台支援消除了針對特定平台的實現方式。 考慮購買許可延期，以便持續獲得更新和支援。

授權許可起價為$799適用於單一開發者），另有團隊和企業選項可供選擇。 每個軟體包都具有獨特的優勢，並且透過節省開發時間，投資即可收回成本。 購買後即可立即取得您的 API 金鑰。 查看許可選項，找到適合您項目的套餐。 隨著需求的增長，您可以考慮升級許可證。

IronPDF 的許可頁面顯示了四個價格等級（Lite 版 749 美元，Plus 版 999 美元，Professional 版 1,999 美元，Unlimited 版 3,999 美元），每個等級都對開發者、地點和項目數量有限制。

動態PDF產生的下一步是什麼？

C# 中的動態 PDF 生成改變了應用程式在運行時交付個人化文件的方式。 IronPDF 提供了一系列必要的工具，可以從HTML 內容、網頁和資料來源建立 PDF 檔案。 其基於 Chrome 的渲染功能可確保您的 PDF 檔案與設計規格完全匹配，而非同步支援則可實現大規模處理。 瀏覽教程，以取得實現這些功能的逐步指導。

以下命令啟動您的進程：Install-Package IronPdf。 使用 IronPDF，您可以轉換 HTML 字串，建立包含圖像和表格的複雜 PDF，新增頁碼，控製字體大小，並從任何資料來源產生PDF 報告。 無論是建立簡單的頁面還是具有多個文件實例的複雜佈局，每個新文件都能受益於像素級完美渲染。 如果您有其他文件安全需求，請考慮使用IronSecuredDoc 。

首先，您可以免費試用 IronPDF 的 30 天版本，體驗這些功能。 瀏覽完整文檔，查看API 文檔中的命名空間參考，並學習程式碼範例，以加速您的 PDF 文件產生專案。 如需其他文件處理功能，包括Excel 操作和OCR ，請考慮使用IronSuite套裝。 查看產品更新，了解最新功能和改進。

常見問題解答

什麼是 C# 動態 PDF 生成？

C# 中的動態 PDF 生成涉及在運行時以程式化方式創建 PDF 文件，允許發票、報告和表單等個性化內容。

IronPDF 如何幫助動態生成 PDF？

IronPDF 提供了強大的基於 Chrome 的渲染功能，能夠與 C# 無縫整合，高效地創建動態 PDF 文件。

IronPDF 可以與 .NET Framework 搭配使用嗎？

是的，IronPDF 與 .NET Framework 完全相容，使其成為在此環境中動態生成 PDF 的強大工具。

動態 PDF 生成的用例有哪些？

動態 PDF 生成對於在現代網路應用程式中建立個人化發票、資料驅動報告和自訂表單欄位非常有用。

為什麼基於 Chrome 的渲染在 PDF 生成中很重要？

基於 Chrome 的渲染可確保高品質且一致的文件外觀，並支援 PDF 生成中的現代網路標準和樣式。

IronPDF 是否適合建立資料驅動的 PDF 報表？

是的，IronPDF 非常適合建立資料驅動的 PDF 報表，讓開發人員可以動態地將資料整合到 PDF 文件中。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術撰稿人

Curtis Chau 擁有電腦科學學士學位（卡爾頓大學），專長於前端開發，精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情，他喜歡使用現代化的架構，並製作結構良好且視覺上吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 也有濃厚的興趣，他喜歡探索整合硬體與軟體的創新方式。在空閒時間，他喜歡玩遊戲和建立 Discord bots，將他對技術的熱愛與創意結合。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用