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のバッチ処理には、メモリ使用量とパフォーマンスを慎重に考慮する必要があります。 効果的なパターンとしては、複数のPDF世代の並列実行のためにTask.WhenAllを使用すること、大きなバッチのためにチャンネルを使ってproducer-consumerパターンを実装すること、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の使用を検討してください。 詳細な[パフォーマンスのトラブルシューティング](/troubleshooting/ironpdf-performance-assistance/)のために、IronPdfは広範なログ機能を提供します。 ```csharp public async Task 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"); } ``` ## PDF生成にマルチスレッドを使用するにはどうすればよいですか? IronPdfはスレッドセーフで、`ChromePdfRenderer`レンダリングエンジンを使用する場合はマルチスレッドをサポートします。マルチスレッドはmacOSマシンでは制限されていることに注意してください。 [Chromeレンダリングエンジン](/how-to/ironpdf-2021-chrome-rendering-engine-eap/)は、並行処理のための優れたスレッド安全性とパフォーマンス特性を提供します。 The Parallel.ForEach pattern works well for batch processing PDFs, allowing you to leverage all available CPU cores effectively. 包括的な[マルチスレッド生成の例](/examples/threading/)については、IronPDFのドキュメントを参照してください。 ### いつ非同期よりもマルチスレッドを選択すべきですか? マルチスレッディングは、十分なシステムリソースで複数のPDFを同時に処理する必要があるCPUバウンド操作に最適です。 マルチスレッドは、マルチコアシステム上で大量のPDFを処理するとき、各PDF生成が独立しているとき、メモリ使用量を制御できるときに選択します。 非同期は、I/Oバウンド操作とアプリケーションの応答性の維持に適しています。 ### スレッド安全性の考慮事項とは