C# 병렬 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
});

Parallel.ForEach(collection, Sub(item)
	' Code to process each item
End Sub)

컬렉션의 각 항목은 병렬로 처리되며 시스템은 사용 가능한 스레드에 작업 부하를 배분하는 방법을 결정합니다. 또한 사용될 최대 스레드 수 등의 병렬성 정도를 제어하는 옵션을 지정할 수 있습니다.

비교하면, 전통적인 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");
});

Dim htmlFiles() As String = { "page1.html", "page2.html", "page3.html" }
Parallel.ForEach(htmlFiles, Sub(htmlFile)
	' Load the HTML content into IronPDF and convert it to PDF
	Dim renderer As New ChromePdfRenderer()
	Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlFile)
	' Save the generated PDF to the output folder
	pdf.SaveAs($"output_{htmlFile}.pdf")
End Sub)

병렬 처리 오류 처리

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

Parallel.ForEach(pdfFiles, Sub(pdfFile)
	Try
		Dim pdf = IronPdf.PdfDocument.FromFile(pdfFile)
		Dim text As String = pdf.ExtractAllText()
		System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text)
	Catch ex As Exception
		Console.WriteLine($"Error processing {pdfFile}: {ex.Message}")
	End Try
End Sub)

여러 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);
        });
    }
}

Imports IronPdf
Imports System.Linq
Imports System.Threading.Tasks

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim pdfFiles() As String = { "doc1.pdf", "doc2.pdf", "doc3.pdf" }
		Parallel.ForEach(pdfFiles, Sub(pdfFile)
			Dim pdf = IronPdf.PdfDocument.FromFile(pdfFile)
			Dim text As String = pdf.ExtractText()
			System.IO.File.WriteAllText($"extracted_{pdfFile}.txt", text)
		End Sub)
	End Sub
End Class

출력 문서

이 코드에서는 각 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}");
            }
        });
    }
}

Imports IronPdf
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim htmlFiles() As String = { "example.html", "example_1.html", "example_2.html" }
		Parallel.ForEach(htmlFiles, Sub(htmlFile)
			Try
				' Load the HTML content into IronPDF and convert it to PDF
				Dim renderer As New ChromePdfRenderer()
				Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf(htmlFile)
				' Save the generated PDF to the output folder
				pdf.SaveAs($"output_{htmlFile}.pdf")
				Console.WriteLine($"PDF created for {htmlFile}")
			Catch ex As Exception
				Console.WriteLine($"Error processing {htmlFile}: {ex.Message}")
			End Try
		End Sub)
	End Sub
End Class

콘솔 출력

PDF 출력

설명

1. HTML 파일: 배열 htmlFiles은(는) PDF로 변환하고자 하는 여러 HTML 파일의 경로를 포함하고 있습니다.

2. 병렬 처리:

   • Parallel.ForEach(htmlFiles, htmlFile => {...})은(는) 각 HTML 파일을 동시에 처리하여 여러 파일을 다룰 때 작업 속도를 높입니다.
   • htmlFiles 배열의 각 파일에 대해 코드가 renderer.RenderHtmlFileAsPdf(htmlFile);을(를) 사용하여 PDF로 변환합니다.

3. PDF 저장: PDF를 생성한 후 pdf.SaveAs 메소드를 사용하여 PDF를 저장하며, 출력 파일 이름에 원본 HTML 파일의 이름을 추가합니다.

4. 오류 처리: 오류가 발생하면 (예: HTML 파일이 없거나 변환 중 문제가 발생하는 경우), try-catch 블록에서 오류가 잡히며 특정 파일에 대한 오류 메시지가 출력됩니다.

IronPDF로 스레드 안전 문제 방지하기

IronPDF는 대부분의 작업에서 스레드 안전성을 보장합니다. 그러나 병렬로 동일 파일에 쓰는 작업은 문제가 발생할 수 있습니다. 항상 각 병렬 작업이 별도의 출력 파일이나 리소스를 사용하도록 해야 합니다.

대규모 데이터셋의 병렬 처리 최적화

성능을 최적화하기 위해 병렬 처리 수준을 제어하는 것을 고려하십시오. 대규모 데이터셋의 경우 시스템 과부하를 방지하기 위해 동시 스레드 수를 제한할 수 있습니다.

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

Dim options = New ExecutionDataflowBlockOptions With {.MaxDegreeOfParallelism = 4}

병렬 PDF 작업 시 메모리 관리

많은 수의 PDF를 처리할 때는 메모리 사용에 주의를 기울여야 합니다. 필요 없게 된 즉시 PdfDocument 객체와 같은 리소스를 해제하려고 시도하십시오.

확장 메서드 사용하기