Parallel.ForEach é um método em C# que permite realizar iterações paralelas sobre uma coleção ou fonte de dados. Em vez de processar cada item da coleção sequencialmente, um loop paralelo permite a execução simultânea, o que pode melhorar significativamente o desempenho, reduzindo o tempo total de execução. O processamento paralelo funciona dividindo o trabalho entre vários processadores principais, permitindo que as tarefas sejam executadas simultaneamente. Isso é particularmente útil ao processar tarefas que são independentes umas das outras.
Ao contrário de um loop foreach normal, que processa os itens sequencialmente, a abordagem paralela consegue lidar com grandes conjuntos de dados muito mais rapidamente, utilizando várias threads em paralelo.
IronPDF é uma biblioteca poderosa para manipulação de PDFs em .NET, capaz de converter HTML em PDF , extrair texto de PDFs , mesclar e dividir documentos , e muito mais. Ao lidar com grandes volumes de tarefas em PDF, o uso de processamento paralelo com Parallel.ForEach pode reduzir significativamente o tempo de execução. Seja para gerar centenas de PDFs ou extrair dados de vários arquivos simultaneamente, o aproveitamento do paralelismo de dados com o IronPDF garante que as tarefas sejam concluídas com mais rapidez e eficiência.
Este guia destina-se a desenvolvedores .NET que desejam otimizar suas tarefas de processamento de PDF usando IronPDF e Parallel.ForEach. Recomenda-se conhecimento básico de C# e familiaridade com a biblioteca IronPDF . Ao final deste guia, você será capaz de implementar o processamento paralelo para lidar com várias tarefas em PDF simultaneamente, melhorando tanto o desempenho quanto a escalabilidade.
Para usar o IronPDF em seu projeto, você precisa instalar a biblioteca via NuGet.
Para instalar o IronPDF, siga estes passos:
Alternativamente, você pode instalá-lo através do Console do Gerenciador de Pacotes NuGet :
Após a instalação do IronPDF , você estará pronto para começar a usá-lo para tarefas de geração e manipulação de PDFs.
Parallel.ForEach é parte do namespace System.Threading.Tasks e fornece uma maneira simples e eficaz de executar iterações simultaneamente. A sintaxe para Parallel.ForEach é a seguinte:
Parallel.ForEach(collection, item =>
{
// Code to process each item
});Parallel.ForEach(collection, Sub(item)
' Code to process each item
End Sub)Cada item da coleção é processado em paralelo, e o sistema decide como distribuir a carga de trabalho entre os threads disponíveis. Você também pode especificar opções para controlar o grau de paralelismo, como o número máximo de threads utilizadas.
Em comparação, um loop foreach tradicional processa cada item um após o outro, enquanto o loop paralelo pode processar múltiplos itens simultaneamente, melhorando o desempenho ao lidar com coleções grandes.
Primeiro, certifique-se de que o IronPDF esteja instalado conforme descrito na seção Introdução. Depois disso, você pode começar a escrever sua lógica de processamento paralelo de 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)Este código demonstra como converter várias páginas HTML em PDFs em paralelo.
Ao lidar com tarefas paralelas, o tratamento de erros é crucial. Use blocos try-catch dentro do loop Parallel.ForEach para gerenciar quaisquer exceções.
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)Outro caso de uso para processamento paralelo é a extração de texto de um lote de PDFs. Ao lidar com vários arquivos PDF, realizar a extração de texto simultaneamente pode economizar muito tempo. O exemplo a seguir demonstra como isso pode ser feito.
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
Neste código, cada arquivo PDF é processado em paralelo para extrair o texto, e o texto extraído é salvo em arquivos de texto separados.
Neste exemplo, vamos gerar vários PDFs a partir de uma lista de arquivos HTML em paralelo, o que pode ser um cenário típico quando você precisa converter várias páginas HTML dinâmicas em documentos 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}");
}
});
}
}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
Arquivos HTML: O array htmlFiles contém caminhos para múltiplos arquivos HTML que você deseja converter em PDFs.
Processamento paralelo:
Parallel.ForEach(htmlFiles, htmlFile => {...}) processa cada arquivo HTML simultaneamente, o que acelera a operação ao lidar com múltiplos arquivos.htmlFiles, o código o converte para um PDF usando renderer.RenderHtmlFileAsPdf(htmlFile);.Salvando o PDF: Após gerar o PDF, ele é salvo usando o método pdf.SaveAs, anexando o nome do arquivo de saída ao nome do arquivo HTML original.
Tratamento de erros: Se ocorrer algum erro (por exemplo, o arquivo HTML não existe ou há um problema durante a conversão), ele é capturado pelo bloco try-catch e uma mensagem de erro é exibida para o arquivo específico.
IronPDF é seguro para uso com múltiplas threads na maioria das operações. No entanto, algumas operações, como escrever no mesmo arquivo em paralelo, podem causar problemas. Assegure-se sempre de que cada tarefa paralela opere em um arquivo de saída ou recurso separado.
Para otimizar o desempenho, considere controlar o grau de paralelismo. Para conjuntos de dados grandes, talvez seja interessante limitar o número de threads simultâneas para evitar sobrecarga do sistema.
var options = new ExecutionDataflowBlockOptions
{
MaxDegreeOfParallelism = 4
};Dim options = New ExecutionDataflowBlockOptions With {.MaxDegreeOfParallelism = 4}Ao processar um grande número de PDFs, fique atento ao uso de memória. Tente liberar recursos como objetos PdfDocument assim que não forem mais necessários.
Um método de extensão é um tipo especial de método estático que permite adicionar novas funcionalidades a um tipo existente sem modificar seu código-fonte. Isso pode ser útil ao trabalhar com bibliotecas como o IronPDF, onde você pode querer adicionar métodos de processamento personalizados ou estender sua funcionalidade para tornar o trabalho com PDFs mais conveniente, especialmente em cenários de processamento paralelo.
Ao utilizar métodos de extensão, você pode criar um código conciso e reutilizável que simplifica a lógica em loops paralelos. Essa abordagem não só reduz a duplicação, como também ajuda a manter um código limpo, especialmente ao lidar com fluxos de trabalho complexos em PDF e paralelismo de dados.
Usar loops paralelos como Parallel.ForEach com IronPDF proporciona ganhos significativos de desempenho ao processar grandes volumes de PDFs. Seja para converter HTML em PDF, extrair texto ou manipular documentos, o paralelismo de dados permite uma execução mais rápida, executando tarefas simultaneamente. A abordagem paralela garante que as operações possam ser executadas em vários processadores principais, o que reduz o tempo total de execução e melhora o desempenho para tarefas de processamento em lote.
Embora o processamento paralelo acelere as tarefas, fique atento à segurança de threads e ao gerenciamento de recursos. O IronPDF é thread-safe para a maioria das operações, mas é importante lidar com possíveis conflitos ao acessar recursos compartilhados. Considere o tratamento de erros e o gerenciamento de memória para garantir a estabilidade, especialmente à medida que sua aplicação cresce.
Se você estiver pronto para se aprofundar no IronPDF e explorar recursos avançados, a documentação oficial fornece informações detalhadas. Além disso, você pode aproveitar a licença de avaliação, que permite testar a biblioteca em seus próprios projetos antes de efetuar a compra.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
