C#で非同期とマルチスレッドを使ってPDFを生成する方法

Updated: 2026年6月29日

IronPDFはC#で非同期処理とマルチスレッドによるハイパフォーマンスなPDF生成を可能にし、複雑なHTMLレンダリングシナリオのバッチ処理時間を同期処理と比較して最大65%短縮します。

クイックスタート: IronPDFを使用して HTML を非同期的に PDF に変換する

IronPDFを使用してわずか数行のコードで非同期PDF生成を開始できます。

RenderHtmlAsPdfAsyncメソッドを使用すると、HTMLコンテンツをPDFに効率的に変換し、アプリケーションのパフォーマンスを最適化できます。このガイドでは、バッチ処理やマルチスレッド環境に最適な、高性能PDF生成のための非同期操作の活用方法を紹介します。

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2このコードスニペットをコピーして実行します。

var pdf = await IronPdf.ChromePdfRenderer.RenderHtmlAsPdfAsync("<h1>Hello World!</h1>");

var pdf = await IronPdf.ChromePdfRenderer.RenderHtmlAsPdfAsync("<h1>Hello World!</h1>");

3実際の環境でテストするためにデプロイする

今日プロジェクトで IronPDF を使い始めましょう無料トライアル

最小限のワークフロー（5ステップ）

非同期およびマルチスレッドPDF生成のためのIronPDFをNuGetからダウンロードする。
変換するためのHTMLコンテンツを準備する
HTMLを非同期にPDFに変換するには、RenderHtmlAsPdfAsyncメソッドを使用してください。
PDF処理におけるマルチスレッドのためのParallel.ForEachメソッドを探求する
さまざまなPDF生成技術のパフォーマンス比較を確認する

C#で非同期PDF生成を実装するには?

IronPDFは、RenderHtmlAsPdfAsyncのようなレンダリングメソッドを使用して、非同期操作を完全にサポートしています。 IronPDFのasync実装はタスクベースの非同期パターン(TAP)を活用し、ノンブロッキングのPDF生成操作を可能にします。このアプローチは、複雑なHTMLコンテンツのレンダリングやPDFリクエストの同時処理に役立ちます。メソッドの完全なリファレンスについては、レンダリングメソッドドキュメントを参照してください。

非同期PDF生成は、デスクトップアプリケーションのUIフリーズを防ぎ、Webアプリケーションのリクエストスループットを向上させます。 awaitパターンを使用することで、PDFレンダリングが完了するのを待つ間、アプリケーションが他の操作を処理できるようになり、応答性とユーザーエクスペリエンスが大きく向上します。

なぜPDF生成に非同期メソッドを使用する必要があるのですか

非同期メソッドは、PDF生成ワークフローに重要な利点を提供します。これらの開発ツールは、リソースを大量に消費する操作中にアプリケーションの応答性を維持し、マルチコアプロセッサでのリソース利用を改善し、サーバー環境でのスケーラビリティを向上させます。複雑なHTMLからPDFへの変換を扱うとき、非同期操作はタイムアウトの問題を防ぎ、ユーザーエクスペリエンスを向上させます。

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);

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);

Imports IronPdf
Imports System.Threading.Tasks

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private htmlStrings() As String = {"<h1>Html 1</h1>", "<h1>Html 2</h1>", "<h1>Html 3</h1>"}

' Create an array to store the tasks for rendering
Private renderingTasks = New Task(Of PdfDocument)(htmlStrings.Length - 1){}

For i As Integer = 0 To htmlStrings.Length - 1
	Dim index As Integer = i ' Capturing the loop variable
	renderingTasks(i) = Task.Run(Async Function()
		' Render HTML to PDF
		Return Await renderer.RenderHtmlAsPdfAsync(htmlStrings(index))
	End Function)
Next i

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

Imports IronPdf
Imports System.Threading.Tasks

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private htmlStrings() As String = {"<h1>Html 1</h1>", "<h1>Html 2</h1>", "<h1>Html 3</h1>"}

' Create an array to store the tasks for rendering
Private renderingTasks = New Task(Of PdfDocument)(htmlStrings.Length - 1){}

For i As Integer = 0 To htmlStrings.Length - 1
	Dim index As Integer = i ' Capturing the loop variable
	renderingTasks(i) = Task.Run(Async Function()
		' Render HTML to PDF
		Return Await renderer.RenderHtmlAsPdfAsync(htmlStrings(index))
	End Function)
Next i

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

バッチ処理の一般的なパターンは何ですか?

PDFのバッチ処理には、メモリ使用量とパフォーマンスを慎重に考慮する必要があります。効果的なパターンには、複数のPDF生成を並行して実行するためのTask.WhenAll使用、大規模バッチの場合のチャネルを使用したプロデューサー・コンシューマーパターンの実装、および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;
}

' Batch processing with progress tracking
Public Async Function ProcessBatchAsync(htmlContents As List(Of String), progress As IProgress(Of Integer)) As Task(Of List(Of PdfDocument))
    Dim renderer = New ChromePdfRenderer()
    Dim results = New List(Of PdfDocument)()
    Dim completed = 0

    Dim tasks = htmlContents.Select(Async Function(html)
                                        Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)
                                        Interlocked.Increment(completed)
                                        If progress IsNot Nothing Then
                                            progress.Report(completed)
                                        End If
                                        Return pdf
                                    End Function)

    results.AddRange(Await Task.WhenAll(tasks))
    Return results
End Function

' Batch processing with progress tracking
Public Async Function ProcessBatchAsync(htmlContents As List(Of String), progress As IProgress(Of Integer)) As Task(Of List(Of PdfDocument))
    Dim renderer = New ChromePdfRenderer()
    Dim results = New List(Of PdfDocument)()
    Dim completed = 0

    Dim tasks = htmlContents.Select(Async Function(html)
                                        Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)
                                        Interlocked.Increment(completed)
                                        If progress IsNot Nothing Then
                                            progress.Report(completed)
                                        End If
                                        Return pdf
                                    End Function)

    results.AddRange(Await Task.WhenAll(tasks))
    Return results
End Function

非同期PDF操作でエラーを処理するには？

非同期PDF操作におけるエラー処理には、包括的な例外管理戦略が必要です。非同期メソッド内で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");
}

Public Async Function RenderWithRetryAsync(html As String, Optional maxRetries As Integer = 3) As Task(Of PdfDocument)
    Dim renderer As New ChromePdfRenderer()

    For i As Integer = 0 To maxRetries - 1
        Try
            Return Await renderer.RenderHtmlAsPdfAsync(html)
        Catch ex As Exception When i < maxRetries - 1
            ' Log the exception
            Await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, i))) ' Exponential backoff
        End Try
    Next

    Throw New InvalidOperationException("Failed to render PDF after maximum retries")
End Function

Public Async Function RenderWithRetryAsync(html As String, Optional maxRetries As Integer = 3) As Task(Of PdfDocument)
    Dim renderer As New ChromePdfRenderer()

    For i As Integer = 0 To maxRetries - 1
        Try
            Return Await renderer.RenderHtmlAsPdfAsync(html)
        Catch ex As Exception When i < maxRetries - 1
            ' Log the exception
            Await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, i))) ' Exponential backoff
        End Try
    Next

    Throw New InvalidOperationException("Failed to render PDF after maximum retries")
End Function

PDF生成にマルチスレッドを使用するにはどうすればよいですか?

IronPDFはスレッドセーフであり、ChromePdfRendererレンダリングエンジンを使用する際にマルチスレッドをサポートしています。macOSマシンではマルチスレッドが制限されていることに注意してください。 Chromeレンダリングエンジンは、並行処理のための優れたスレッド安全性とパフォーマンス特性を提供します。

Parallel.ForEachパターンは、利用可能なすべてのCPUコアを効果的に活用して、バッチ処理PDFに適しています。包括的なマルチスレッド生成の例については、IronPDFのドキュメントを参照してください。

いつ非同期よりもマルチスレッドを選択すべきですか?

マルチスレッディングは、十分なシステムリソースで複数のPDFを同時に処理する必要があるCPUバウンド操作に最適です。マルチスレッドは、マルチコアシステム上で大量の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");
        });
}

' Thread-safe PDF generation with custom settings per thread
Public Sub ProcessPdfsInParallel(htmlContents As List(Of String))
    Parallel.ForEach(htmlContents, New ParallelOptions With {.MaxDegreeOfParallelism = Environment.ProcessorCount},
        Sub(html)
            ' Create a new renderer instance for each thread
            Dim renderer = New ChromePdfRenderer With {
                .RenderingOptions = New ChromePdfRenderOptions With {
                    .MarginTop = 10,
                    .MarginBottom = 10,
                    .PaperSize = IronPdf.Rendering.PdfPaperSize.A4
                }
            }

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

' Thread-safe PDF generation with custom settings per thread
Public Sub ProcessPdfsInParallel(htmlContents As List(Of String))
    Parallel.ForEach(htmlContents, New ParallelOptions With {.MaxDegreeOfParallelism = Environment.ProcessorCount},
        Sub(html)
            ' Create a new renderer instance for each thread
            Dim renderer = New ChromePdfRenderer With {
                .RenderingOptions = New ChromePdfRenderOptions With {
                    .MarginTop = 10,
                    .MarginBottom = 10,
                    .PaperSize = IronPdf.Rendering.PdfPaperSize.A4
                }
            }

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

いくつの同時スレッドを使用する必要がありますか?

最適な同時スレッド数は、CPUコア、利用可能なメモリ、PDFの複雑さによって異なります。一般的なガイドラインには、CPUバウンド操作のためのEnvironment.ProcessorCountの使用、メモリ集約型PDFには2〜4スレッドに制限し、最適な構成を見つけるためにシステムリソースを監視することが含まれます。 async の例は、さまざまなスレッド戦略を示しています。

私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。

Milan Jovanovic

Microsoft MVP

ケーススタディを見る

IronOCRのおかげで私たちは年間$40,000を手作業の処理から節約し、生産性を向上させ、高影響のタスクにリソースを充てることができます。非常にお勧めします。

Brent Matzelle

最高技術責任者, OPYN

ケーススタディを見る

どのようなパフォーマンスの向上が期待できますか?

比較の結果、レンダリング・アプローチによってパフォーマンスに大きな違いがあることがわかりました。 WaitForクラスを用いたレンダリングには、複雑なHTMLレンダリングをシミュレートするために5秒の遅延が追加されます。以下に、上記のさまざまなテクニックを使用した場合のパフォーマンスの比較表を示します。

なぜ非同期は同期よりもパフォーマンスが良いのですか

通常レンダリング	非同期レンダー	マルチスレッドレンダー
15.75秒	05.59秒	05.68秒

非同期処理は、効率的なスレッドプールリソース管理を可能にし、メインスレッドのブロッキングを防ぎ、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;
}

Public Async Function MeasurePerformanceAsync(html As String, iterations As Integer) As Task(Of PerformanceMetrics)
    Dim metrics = New PerformanceMetrics()
    Dim renderer = New ChromePdfRenderer()
    Dim stopwatch = New Stopwatch()
    
    ' Warm-up run
    Await renderer.RenderHtmlAsPdfAsync(html)
    
    For i As Integer = 0 To iterations - 1
        stopwatch.Restart()
        Await renderer.RenderHtmlAsPdfAsync(html)
        stopwatch.Stop()
        
        metrics.AddMeasurement(stopwatch.ElapsedMilliseconds)
    Next
    
    Return metrics
End Function

Public Async Function MeasurePerformanceAsync(html As String, iterations As Integer) As Task(Of PerformanceMetrics)
    Dim metrics = New PerformanceMetrics()
    Dim renderer = New ChromePdfRenderer()
    Dim stopwatch = New Stopwatch()
    
    ' Warm-up run
    Await renderer.RenderHtmlAsPdfAsync(html)
    
    For i As Integer = 0 To iterations - 1
        stopwatch.Restart()
        Await renderer.RenderHtmlAsPdfAsync(html)
        stopwatch.Stop()
        
        metrics.AddMeasurement(stopwatch.ElapsedMilliseconds)
    Next
    
    Return metrics
End Function

PDF生成速度に影響する要因は何ですか

PDF生成のパフォーマンスにはいくつかの要因が影響します。 JavaScriptの実行やCSSのレンダリングなど、HTMLの複雑さは処理時間に直接影響します。画像やフォントなどの外部リソースの読み込みは、遅延を引き起こす可能性があります。 CPU、メモリ、ディスクI/Oなどのシステムリソースが重要な役割を果たします。レンダリングオプションやエンジン設定を含むIronPDFの設定もスピードに影響します。これらの要素を理解することで、PDF生成のワークフローを最適化し、効率を最大限に高めることができます。

重いJavaScriptや遅延レンダリングを含む複雑なシナリオでは、PDF生成前に完全なページレンダリングを保証するためにWaitForメカニズムの使用を検討してください。このアプローチは、予測可能なパフォーマンス特性を維持しながら、正確な出力を保証します。

よくある質問

非同期PDF生成でどの程度のパフォーマンス向上が期待できますか？

IronPDFの非同期処理とマルチスレッドにより、特に複雑なHTMLコンテンツをレンダリングする場合、バッチ処理時間を同期処理に比べて最大65%短縮することができます。実際の性能向上はHTMLの複雑さ、システムリソース、同時処理数などの要因に依存します。

HTMLを非同期でPDFに変換する最も簡単な方法は何ですか？

最もシンプルな方法はIronPDFのRenderHtmlAsPdfAsyncメソッドを使うことです。たった1行のコードでvar pdf = await IronPdf.ChromePdfRenderer.RenderHtmlAsPdfAsync("Hello World!");`, アプリケーションの応答性を維持しながら効率的にHTMLコンテンツをPDFに変換することができます。

なぜ、同期PDF生成の代わりに非同期メソッドを使う必要があるのですか？

IronPDFの非同期メソッドはデスクトップアプリケーションのUIのフリーズを防ぎ、Webアプリケーションのリクエストスループットを向上させ、マルチコアプロセッサのリソース利用を改善し、サーバー環境のスケーラビリティを向上させます。複雑なHTMLからPDFへの変換や、複数のPDFリクエストを同時に処理する場合に特に有益です。

ライブラリはPDF操作にどのような非同期パターンを使用しますか？

IronPDFはRenderHtmlAsPdfAsyncのようなメソッドを含む非同期操作のためにTask-based Asynchronous Pattern (TAP)を実装しています。このパターンはノンブロッキングのPDF生成操作を可能にし、C#のasync/awaitキーワードとシームレスに統合します。

パフォーマンスを向上させるために、複数のPDFを並列処理するにはどうすればよいですか？

IronPDFは複数のPDF世代の並列実行のためのTask.WhenAll、PDF処理のマルチスレッド化のためのParallel.ForEach、そして大規模バッチのためのチャンネルを持つproducer-consumerパターンのようなパターンを使ったバッチ処理をサポートします。これらのアプローチは、リソースの使用を最適化し、総処理時間を大幅に短縮します。