如何在 C# 中使用非同步和多執行緒產生 PDF

為什麼生成 PDF 檔案時應該使用非同步方法？

非同步方法為 PDF 生成工作流程提供了關鍵優勢。 它們在資源密集型操作期間保持應用程式的回應能力，在多核心處理器上實現更好的資源利用率，並提高伺服器環境的可擴展性。 在處理複雜的 HTML 到 PDF 轉換時，非同步操作可以防止逾時問題並改善使用者體驗。

:path=/static-assets/pdf/content-code-examples/how-to/async-async.cs

using IronPdf;
using System.Threading.Tasks;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

string[] htmlStrings = {"<h1>Html 1</h1>", "<h1>Html 2</h1>", "<h1>Html 3</h1>"};

// Create an array to store the tasks for rendering
var renderingTasks = new Task<PdfDocument>[htmlStrings.Length];

for (int i = 0; i < htmlStrings.Length; i++)
{
    int index = i; // Capturing the loop variable
    renderingTasks[i] = Task.Run(async () =>
    {
        // Render HTML to PDF
        return await renderer.RenderHtmlAsPdfAsync(htmlStrings[index]);
    });
}

// Wait for all rendering tasks to complete
// await Task.WhenAll(renderingTasks);

批量處理的常見模式有哪些？

批次處理 PDF 檔案需要仔細考慮記憶體使用和效能。 有效的模式包括使用 Task.WhenAll 並行執行多個 PDF 生成，使用通道實現生產者-消費者模式以處理大批量數據，以及利用IronPDF文檔中的平行處理範例。

// Batch processing with progress tracking
public async Task<List<PdfDocument>> ProcessBatchAsync(List<string> htmlContents, IProgress<int> progress)
{
    var renderer = new ChromePdfRenderer();
    var results = new List<PdfDocument>();
    var completed = 0;

    var tasks = htmlContents.Select(async html => {
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);
        Interlocked.Increment(ref completed);
        progress?.Report(completed);
        return pdf;
    });

    results.AddRange(await Task.WhenAll(tasks));
    return results;
}

// Batch processing with progress tracking
public async Task<List<PdfDocument>> ProcessBatchAsync(List<string> htmlContents, IProgress<int> progress)
{
    var renderer = new ChromePdfRenderer();
    var results = new List<PdfDocument>();
    var completed = 0;

    var tasks = htmlContents.Select(async html => {
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);
        Interlocked.Increment(ref completed);
        progress?.Report(completed);
        return pdf;
    });

    results.AddRange(await Task.WhenAll(tasks));
    return results;
}

如何處理非同步 PDF 操作中的錯誤？

非同步 PDF 操作中的錯誤處理需要全面的異常管理策略。 在非同步方法中使用 try-catch 區塊，為瞬態故障實作重試邏輯，並考慮使用 Polly 來實現高階重試策略。 IronPDF提供強大的日誌記錄功能，可用於詳細檢查效能問題。

public async Task<PdfDocument> RenderWithRetryAsync(string html, int maxRetries = 3)
{
    var renderer = new ChromePdfRenderer();

    for (int i = 0; i < maxRetries; i++)
    {
        try
        {
            return await renderer.RenderHtmlAsPdfAsync(html);
        }
        catch (Exception ex) when (i < maxRetries - 1)
        {
            // Log the exception
            await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, i))); // Exponential backoff
        }
    }

    throw new InvalidOperationException("Failed to render PDF after maximum retries");
}

public async Task<PdfDocument> RenderWithRetryAsync(string html, int maxRetries = 3)
{
    var renderer = new ChromePdfRenderer();

    for (int i = 0; i < maxRetries; i++)
    {
        try
        {
            return await renderer.RenderHtmlAsPdfAsync(html);
        }
        catch (Exception ex) when (i < maxRetries - 1)
        {
            // Log the exception
            await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, i))); // Exponential backoff
        }
    }

    throw new InvalidOperationException("Failed to render PDF after maximum retries");
}

何時應該選擇多執行緒而不是異步？

多執行緒非常適合 CPU 密集型操作，例如需要同時處理多個 PDF 檔案且需要充足系統資源的情況。 在多核心系統上處理大量 PDF 檔案、每次 PDF 產生都是獨立的、並且可以控制記憶體使用量時，請選擇多執行緒。 非同步操作更適合 I/O 密集型操作，並能維持應用程式的回應速度。

螺紋安全需要考慮哪些因素？

IronPDF 的 ChromePdfRenderer 設計為線程安全，但仍需注意某些事項。 使用自訂設定時，為每個執行緒建立單獨的渲染器實例；避免在執行緒之間共用 PdfDocument 實例而不進行同步；並監控並發處理大型文件時的記憶體消耗。 安裝概述提供了有關配置IronPDF以獲得最佳線程安全性的更多詳細資訊。

// Thread-safe PDF generation with custom settings per thread
public void ProcessPdfsInParallel(List<string> htmlContents)
{
    Parallel.ForEach(htmlContents, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, 
        html =>
        {
            // Create a new renderer instance for each thread
            var renderer = new ChromePdfRenderer
            {
                RenderingOptions = new ChromePdfRenderOptions
                {
                    MarginTop = 10,
                    MarginBottom = 10,
                    PaperSize = IronPdf.Rendering.PdfPaperSize.A4
                }
            };

            var pdf = renderer.RenderHtmlAsPdf(html);
            pdf.SaveAs($"output_{Thread.CurrentThread.ManagedThreadId}_{DateTime.Now.Ticks}.pdf");
        });
}

// Thread-safe PDF generation with custom settings per thread
public void ProcessPdfsInParallel(List<string> htmlContents)
{
    Parallel.ForEach(htmlContents, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, 
        html =>
        {
            // Create a new renderer instance for each thread
            var renderer = new ChromePdfRenderer
            {
                RenderingOptions = new ChromePdfRenderOptions
                {
                    MarginTop = 10,
                    MarginBottom = 10,
                    PaperSize = IronPdf.Rendering.PdfPaperSize.A4
                }
            };

            var pdf = renderer.RenderHtmlAsPdf(html);
            pdf.SaveAs($"output_{Thread.CurrentThread.ManagedThreadId}_{DateTime.Now.Ticks}.pdf");
        });
}

我應該使用多少個並發線程？

最佳並發執行緒數取決於 CPU 核心數、可用記憶體和 PDF 複雜度。 一般準則包括：對 CPU 密集型操作使用 Environment.ProcessorCount，對記憶體密集型 PDF 限制為 2-4 個線程，以及監控系統資源以找到最佳配置。 非同步範例演示了各種線程策略。

為什麼非同步程式設計比同步程式設計效能更好？

非同步操作的優點在於能夠有效管理執行緒池資源，防止主執行緒阻塞，並在 I/O 操作期間更好地利用 CPU。 效能提升來自於同時啟動多個渲染操作，而不是等待每個操作按順序完成。

如何衡量應用程式的效能？

衡量 PDF 生成效能需要進行適當的基準測試和監控。 使用 System.Diagnostics.Stopwatch 進行精確的時間測量，實現自訂效能計數器以進行生產監控，並利用應用程式洞察或類似的 APM 工具。 可以考慮使用快速入門指南中的範例作為效能測試的基準。

public async Task<PerformanceMetrics> MeasurePerformanceAsync(string html, int iterations)
{
    var metrics = new PerformanceMetrics();
    var renderer = new ChromePdfRenderer();
    var stopwatch = new Stopwatch();

    // Warm-up run
    await renderer.RenderHtmlAsPdfAsync(html);

    for (int i = 0; i < iterations; i++)
    {
        stopwatch.Restart();
        await renderer.RenderHtmlAsPdfAsync(html);
        stopwatch.Stop();

        metrics.AddMeasurement(stopwatch.ElapsedMilliseconds);
    }

    return metrics;
}

public async Task<PerformanceMetrics> MeasurePerformanceAsync(string html, int iterations)
{
    var metrics = new PerformanceMetrics();
    var renderer = new ChromePdfRenderer();
    var stopwatch = new Stopwatch();

    // Warm-up run
    await renderer.RenderHtmlAsPdfAsync(html);

    for (int i = 0; i < iterations; i++)
    {
        stopwatch.Restart();
        await renderer.RenderHtmlAsPdfAsync(html);
        stopwatch.Stop();

        metrics.AddMeasurement(stopwatch.ElapsedMilliseconds);
    }

    return metrics;
}

哪些因素會影響PDF生成速度？

影響PDF生成性能的因素有很多。 HTML 的複雜性，包括JavaScript執行和 CSS 渲染，會直接影響處理時間。外部資源加載，例如圖片和字體，也會引入延遲。 CPU、記憶體和磁碟 I/O 等系統資源發揮著至關重要的作用。 IronPDF 的配置，包括渲染選項和引擎設置，也會影響速度。 了解這些因素有助於優化您的 PDF 生成工作流程，從而最大限度地提高效率。

對於涉及大量JavaScript或延遲渲染的複雜場景，請考慮使用WaitFor 機制來確保在產生 PDF 之前完成頁面渲染。 這種方法既能保證輸出準確，又能維持可預測的性能特性。