C# Paralel Foreach (Geliştiriciler İçin Nasıl Çalışır)

IronPDF Kurulumu

Install-Package IronPdf

C#'ta Parallel.ForEach'in Temel Kavramları

Parallel.ForEach, System.Threading.Tasks ad alanının bir parçasıdır ve yinelemeleri eşzamanlı olarak yürütmek için basit ve etkili bir yol sağlar. Parallel.ForEach için sözdizimi aşağıdaki gibidir:

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)

Koleksiyondaki her bir öğe paralel olarak işlenir ve sistem iş yükünü mevcut iş parçacıklarına nasıl dağıtacağına karar verir. Paralellik derecesini kontrol etmek için, kullanılan maksimum iş parçacığı sayısı gibi seçenekleri de belirtebilirsiniz.

Karşılaştırıldığında, geleneksel bir foreach döngüsü her bir öğeyi ardı ardına işlerken, paralel döngü birden fazla öğeyi eşzamanlı olarak işleyebilir ve büyük koleksiyonlar işlenirken performansı artırır.

Projeyi Kurma

Öncelikle, Başlarken bölümünde açıklandığı gibi IronPDF'nin kurulu olduğundan emin olun. Bundan sonra, paralel PDF işleme mantığınızı yazmaya başlayabilirsiniz.

Paralel İşleme Mantığını Yazma

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)

Paralel İşleme Hatalarını Yönetme

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)

Çoklu PDF'lerden Eşzamanlı Olarak Metin Çıkarma

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

Çıktı Belgeleri

Bu kodda, her bir PDF dosyası paralel olarak işlenerek metin çıkarılır ve çıkarılan metin ayrı metin dosyalarına kaydedilir.

Örnek: HTML Dosyalarından Paralel Olarak Toplu PDF Üretme

Bu örnekte, paralel olarak bir liste HTML dosyasından birden fazla PDF üreteceğiz, bu da birkaç dinamik HTML sayfasını PDF belgelerine dönüştürmeniz gerektiğinde tipik bir senaryo olabilir.

Kod

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

Konsol Çıktısı

PDF Çıktısı

Açıklama

1. HTML Dosyaları: htmlFiles dizisi, PDF'lere dönüştürmek istediğiniz birden fazla HTML dosyasına giden yolları içerir.

2. Paralel İşleme:

   • Parallel.ForEach(htmlFiles, htmlFile => {...}) her bir HTML dosyasını eşzamanlı olarak işler, bu da birden fazla dosya ile çalışırken işlemi hızlandırır.
   • htmlFiles dizisindeki her bir dosya için, kod renderer.RenderHtmlFileAsPdf(htmlFile); kullanarak onu bir PDF'ye dönüştürür.

3. PDF'yi Kaydetmek: PDF oluşturulduktan sonra, pdf.SaveAs yöntemi kullanılarak kaydedilir ve çıkış dosya adı orijinal HTML dosyasının adıyla birleştirilir.

4. Hata Yönetimi: Herhangi bir hata oluşursa (örneğin, HTML dosyası mevcut değilse veya dönüştürme sırasında bir sorun varsa), try-catch bloğu tarafından yakalanır ve özgün dosya için bir hata mesajı yazdırılır.

IronPDF ile İş Parçacığı Güvenliği Sorunlarından Kaçınma

IronPDF çoğu işlem için iş parçacığı dostudur. Ancak, aynı dosyaya paralel olarak yazmak gibi bazı işlemler sorunlara neden olabilir. Her zaman her paralel görevin ayrı bir çıktı dosyası veya kaynak üzerine çalıştığından emin olun.

Büyük Veri Setleri İçin Paralel İşlemeyi Optimize Etme

Performansı optimize etmek için, paralellik derecesini kontrol etmeyi düşünebilirsiniz. Büyük veri setleri için, sistem patlamasını önlemek için eşzamanlı iş parçacığı sayısını sınırlamak isteyebilirsiniz.

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

var options = new ExecutionDataflowBlockOptions
{
    MaxDegreeOfParallelism = 4
};

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

Paralel PDF İşlemlerinde Bellek Yönetimi

Çok sayıda PDF işlerken, bellek kullanımı konusunda dikkatli olunmalıdır. Gibi kaynakları, artık gerekmediklerinde mümkün olan en kısa sürede serbest bırakmaya çalışın: PdfDocument nesneleri.

Uzatma Yöntemlerini Kullanma