C# Parallel Foreach（開発者向けの仕組み）

IronPDFのインストール

Install-Package IronPdf

Basic Concepts of Parallel.ForEach in C

Parallel.ForEach は System.Threading.Tasks 名前空間の一部であり、反復処理を同時に実行するためのシンプルで効果的な方法を提供します。 Parallel.ForEach の構文は次のとおりです。

Parallel.ForEach(collection, item =>
{
    // Code to process each item
});

Parallel.ForEach(collection, item =>
{
    // Code to process each item
});

コレクション内の各アイテムは並行して処理され、システムが利用可能なスレッドに負荷を分散する方法を決定します。 使用するスレッド数の最大数など、並列度を制御するオプションを指定することもできます。

比較すると、従来の foreach ループは各項目を 1 つずつ処理しますが、並列ループは複数の項目を同時に処理できるため、大規模なコレクションを処理する際のパフォーマンスが向上します。

プロジェクトのセットアップ

まず、IronPDFが開始セクションに記載されているようにインストールされていることを確認します。 その後、並列PDF処理のロジックを記述し始めることができます。

並列処理ロジックの記述

string[] htmlFiles = { "page1.html", "page2.html", "page3.html" };
Parallel.ForEach(htmlFiles, htmlFile =>
{
    // Load the HTML content into IronPDF and convert it to PDF
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlFile);
    // Save the generated PDF to the output folder
    pdf.SaveAs($"output_{htmlFile}.pdf");
});

string[] htmlFiles = { "page1.html", "page2.html", "page3.html" };
Parallel.ForEach(htmlFiles, htmlFile =>
{
    // Load the HTML content into IronPDF and convert it to PDF
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlFile);
    // Save the generated PDF to the output folder
    pdf.SaveAs($"output_{htmlFile}.pdf");
});

並列処理エラーの処理

Parallel.ForEach(pdfFiles, pdfFile =>
{
    try
    {
        var pdf = IronPdf.PdfDocument.FromFile(pdfFile);
        string text = pdf.ExtractAllText();
        System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error processing {pdfFile}: {ex.Message}");
    }
});

Parallel.ForEach(pdfFiles, pdfFile =>
{
    try
    {
        var pdf = IronPdf.PdfDocument.FromFile(pdfFile);
        string text = pdf.ExtractAllText();
        System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error processing {pdfFile}: {ex.Message}");
    }
});

複数のPDFからの同時テキスト抽出

using IronPdf;
using System.Linq;
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        string[] pdfFiles = { "doc1.pdf", "doc2.pdf", "doc3.pdf" };
        Parallel.ForEach(pdfFiles, pdfFile =>
        {
            var pdf = IronPdf.PdfDocument.FromFile(pdfFile);
            string text = pdf.ExtractText();
            System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text);
        });
    }
}

using IronPdf;
using System.Linq;
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        string[] pdfFiles = { "doc1.pdf", "doc2.pdf", "doc3.pdf" };
        Parallel.ForEach(pdfFiles, pdfFile =>
        {
            var pdf = IronPdf.PdfDocument.FromFile(pdfFile);
            string text = pdf.ExtractText();
            System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text);
        });
    }
}

出力ドキュメント

このコードでは、それぞれのPDFファイルが並列処理され、テキストが抽出され、別々のテキストファイルに保存されます。

HTMLファイルからのバッチPDF生成を並列で実行する例

この例では、複数のHTMLファイルのリストから並列にPDFを生成します。動的HTMLページを複数のPDFドキュメントに変換する必要がある典型的なシナリオです。

コード

using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        string[] htmlFiles = { "example.html", "example_1.html", "example_2.html" };
        Parallel.ForEach(htmlFiles, htmlFile =>
        {
            try
            {
                // Load the HTML content into IronPDF and convert it to PDF
                ChromePdfRenderer renderer = new ChromePdfRenderer();
                PdfDocument pdf = renderer.RenderHtmlFileAsPdf(htmlFile);
                // Save the generated PDF to the output folder
                pdf.SaveAs($"output_{htmlFile}.pdf");
                Console.WriteLine($"PDF created for {htmlFile}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error processing {htmlFile}: {ex.Message}");
            }
        });
    }
}

using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        string[] htmlFiles = { "example.html", "example_1.html", "example_2.html" };
        Parallel.ForEach(htmlFiles, htmlFile =>
        {
            try
            {
                // Load the HTML content into IronPDF and convert it to PDF
                ChromePdfRenderer renderer = new ChromePdfRenderer();
                PdfDocument pdf = renderer.RenderHtmlFileAsPdf(htmlFile);
                // Save the generated PDF to the output folder
                pdf.SaveAs($"output_{htmlFile}.pdf");
                Console.WriteLine($"PDF created for {htmlFile}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error processing {htmlFile}: {ex.Message}");
            }
        });
    }
}

コンソール出力

PDF出力

説明

1. HTML ファイル:配列 htmlFiles には、PDF に変換する複数の HTML ファイルへのパスが含まれています。

2. 並列処理:

   • Parallel.ForEach(htmlFiles, htmlFile => {...}) は各 HTML ファイルを同時に処理するため、複数のファイルを扱う際の操作が高速化されます。
   • htmlFiles 配列内の各ファイルに対して、コードは renderer.RenderHtmlFileAsPdf(htmlFile); を使用して PDF に変換します。

3. PDF の保存: PDF を生成した後、pdf.SaveAs メソッドを使用して保存され、出力ファイル名に元の HTML ファイルの名前が追加されます。

4. エラー処理: エラーが発生した場合(例：HTMLファイルが存在しない、変換中に問題が発生したなど)、try-catchブロックによって捕捉され、特定のファイルに対してエラーメッセージが出力されます。

IronPDFでのスレッドセーフティ問題の回避

IronPDFはほとんどの操作においてスレッドセーフです。 ただし、並列で同じファイルに書き込むような操作には問題が発生する可能性があります。 常に各並列タスクが別の出力ファイルやリソースを操作するようにしてください。

大規模データセットのための並列処理最適化

パフォーマンスを最適化するには、並列度の制御を考慮する必要があります。 大規模なデータセットに対しては、システムへの負荷を防ぐため、同時実行スレッド数を制限することを検討してください。

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

並列PDF操作におけるメモリ管理

大量のPDFを処理する際は、メモリ使用量に注意が必要です。 PdfDocument オブジェクトなどのリソースは、不要になったらすぐに解放するようにしてください。

拡張メソッドの使用