Parallel.ForEach es un método en C# que te permite realizar iteraciones en paralelo sobre una colección o fuente de datos. En lugar de procesar cada elemento en la colección secuencialmente, un bucle paralelo permite una ejecución concurrente, lo que puede mejorar significativamente el rendimiento al reducir el tiempo total de ejecución. El procesamiento paralelo funciona dividiendo el trabajo entre múltiples procesadores de núcleo, permitiendo que las tareas se ejecuten simultáneamente. Esto es particularmente útil cuando se procesan tareas que son independientes entre sí.
En contraste con un bucle foreach normal, que procesa elementos secuencialmente, el enfoque paralelo puede manejar grandes conjuntos de datos mucho más rápido al utilizar múltiples hilos en paralelo.
IronPDF es una potente librería para gestionar PDFs en .NET, capaz de convertir HTML a PDF, extraer texto de PDFs, fusionar y dividir documentos, y más. Cuando se trata de volúmenes grandes de tareas PDF, usar procesamiento paralelo con Parallel.ForEach puede reducir significativamente el tiempo de ejecución. Ya sea que estés generando cientos de PDFs o extrayendo datos de múltiples archivos a la vez, aprovechar el paralelismo de datos con IronPDF asegura que las tareas se completen más rápido y de manera más eficiente.
Esta guía está destinada a desarrolladores .NET que desean optimizar sus tareas de procesamiento de PDF usando IronPDF y Parallel.ForEach. Se recomienda tener conocimientos básicos de C# y familiaridad con la librería IronPDF. Al final de esta guía, serás capaz de implementar procesamiento paralelo para manejar múltiples tareas PDF simultáneamente, mejorando tanto el rendimiento como la escalabilidad.
Para usar IronPDF en tu proyecto, necesitas instalar la biblioteca a través de NuGet.
Para instalar IronPDF, sigue estos pasos:
Alternativamente, puedes instalarlo a través de la Consola del Administrador de Paquetes NuGet:
Una vez que IronPDF esté instalado, estás listo para comenzar a usarlo para tareas de generación y manipulación de PDF.
Parallel.ForEach es parte del espacio de nombres System.Threading.Tasks y proporciona una manera simple y efectiva de ejecutar iteraciones concurrentemente. La sintaxis para Parallel.ForEach es la siguiente:
Parallel.ForEach(collection, item =>
{
// Code to process each item
});Parallel.ForEach(collection, Sub(item)
' Code to process each item
End Sub)Cada elemento en la colección se procesa en paralelo, y el sistema decide cómo distribuir la carga de trabajo entre los hilos disponibles. También puedes especificar opciones para controlar el grado de paralelismo, como el número máximo de hilos utilizados.
En comparación, un bucle tradicional foreach procesa cada elemento uno tras otro, mientras que el bucle paralelo puede procesar múltiples elementos simultáneamente, mejorando el rendimiento al manejar colecciones grandes.
Primero, asegúrate de que IronPDF esté instalado como se describe en la sección Comenzando. Después de eso, puedes comenzar a escribir tu lógica de procesamiento 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 demuestra cómo convertir múltiples páginas HTML a PDFs en paralelo.
Cuando trabajas con tareas paralelas, el manejo de errores es crucial. Use bloques try-catch dentro del bucle Parallel.ForEach para gestionar cualquier excepción.
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)Otro caso de uso para el procesamiento paralelo es extraer texto de un lote de PDFs. Cuando se trabaja con múltiples archivos PDF, realizar la extracción de texto de forma concurrente puede ahorrar mucho tiempo. El siguiente ejemplo demuestra cómo puede lograrse.
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
En este código, cada archivo PDF se procesa en paralelo para extraer texto, y el texto extraído se guarda en archivos de texto separados.
En este ejemplo, generaremos múltiples PDFs a partir de una lista de archivos HTML en paralelo, lo que podría ser un escenario típico cuando necesitas convertir varias páginas HTML dinámicas a 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
Archivos HTML: El arreglo htmlFiles contiene rutas a múltiples archivos HTML que desea convertir en PDFs.
Procesamiento Paralelo:
Parallel.ForEach(htmlFiles, htmlFile => {...}) procesa cada archivo HTML concurrentemente, lo que acelera la operación al trabajar con múltiples archivos.htmlFiles, el código lo convierte a un PDF usando renderer.RenderHtmlFileAsPdf(htmlFile);.Guardando el PDF: Después de generar el PDF, se guarda utilizando el método pdf.SaveAs, agregando el nombre del archivo de salida con el nombre del archivo HTML original.
Manejo de Errores: Si ocurre algún error (por ejemplo, el archivo HTML no existe o hay un problema durante la conversión), se captura por el bloque try-catch y se imprime un mensaje de error para el archivo específico.
IronPDF es seguro para hilos en la mayoría de las operaciones. Sin embargo, algunas operaciones como escribir en el mismo archivo en paralelo pueden causar problemas. Asegúrate siempre de que cada tarea paralela opere en un archivo de salida o recurso separado.
Para optimizar el rendimiento, considera controlar el grado de paralelismo. Para grandes conjuntos de datos, puede desear limitar el número de hilos concurrentes para evitar sobrecargar el sistema.
var options = new ExecutionDataflowBlockOptions
{
MaxDegreeOfParallelism = 4
};Dim options = New ExecutionDataflowBlockOptions With {.MaxDegreeOfParallelism = 4}Al procesar un gran número de PDFs, ten en cuenta el uso de memoria. Intente liberar recursos como objetos PdfDocument tan pronto como ya no sean necesarios.
Un método de extensión es un tipo especial de método estático que te permite agregar nueva funcionalidad a un tipo existente sin modificar su código fuente. Esto puede ser útil al trabajar con librerías como IronPDF, donde podrías querer agregar métodos de procesamiento personalizados o extender su funcionalidad para hacer más conveniente trabajar con PDFs, especialmente en escenarios de procesamiento paralelo.
Al usar métodos de extensión, puedes crear un código conciso y reutilizable que simplifica la lógica en bucles paralelos. Este enfoque no sólo reduce la duplicación, sino que también te ayuda a mantener una base de código limpia, especialmente al tratar con flujos de trabajo PDF complejos y el paralelismo de datos.
El uso de bucles paralelos como Parallel.ForEach con IronPDF proporciona ganancias significativas en rendimiento al procesar grandes volúmenes de PDFs. Ya sea que estés convirtiendo HTML a PDFs, extrayendo texto o manipulando documentos, el paralelismo de datos permite una ejecución más rápida al ejecutar tareas concurrentemente. El enfoque paralelo asegura que las operaciones se puedan ejecutar en múltiples procesadores de núcleo, lo que reduce el tiempo total de ejecución y mejora el rendimiento para tareas de procesamiento por lotes.
Aunque el procesamiento paralelo acelera las tareas, ten en cuenta la seguridad de hilos y la gestión de recursos. IronPDF es seguro para hilos en la mayoría de las operaciones, pero es importante manejar posibles conflictos al acceder a recursos compartidos. Considera el manejo de errores y la gestión de memoria para asegurar la estabilidad, especialmente a medida que tu aplicación escala.
Si estás listo para profundizar en IronPDF y explorar características avanzadas, la documentación oficial proporciona amplia información. Además, puedes aprovechar su licencia de prueba, permitiéndote probar la biblioteca en tus propios proyectos antes de comprometerte a una compra.
Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
