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

IronPDFのインストール

Install-Package IronPdf

C#におけるParallel.ForEachの基本概念

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ループは各アイテムを一つずつ処理しますが、並列ループは複数のアイテムを同時に処理でき、大量のコレクションを扱う際のパフォーマンスが向上します。

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

まず、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オブジェクトなどのリソースは、不要になったらすぐに解放するように心がけてください。

拡張メソッドの使用