La interfaz IEnumerable de C# es una de las herramientas más versátiles en el framework .NET, permitiendo a los desarrolladores trabajar con colecciones de manera altamente flexible. Cuando se combina con IronPDF, IEnumerable permite la manipulación dinámica de datos y la generación eficiente de PDFs, siendo ideal para escenarios como crear informes, exportar datos o generar documentos a partir de consultas a la base de datos.
Usar IEnumerable asegura que tu aplicación permanezca escalable y eficiente en memoria, ya que procesa datos de manera perezosa y evita cargar conjuntos de datos enteros en la memoria de una sola vez. Esto es especialmente útil para aplicaciones a gran escala que manejan colecciones extensas de datos, como una gran tabla de base de datos.
IronPDF es una potente biblioteca .NET diseñada para simplificar el proceso de crear, editar y gestionar archivos PDF de manera programática. Ofrece una amplia gama de funciones, incluyendo conversión de HTML a PDF, extracción de texto, fusión de PDFs, y más. Integrando IronPDF en tus proyectos de C#, puedes manejar eficientemente tareas complejas de PDF sin necesitar un profundo conocimiento en los aspectos internos del PDF.
IronPDF también soporta una variedad de formatos, lo que te permite generar PDFs a partir de HTML en bruto, Vistas Razor, páginas web ASP.NET, o incluso directamente desde estructuras de datos. Esta flexibilidad lo convierte en una herramienta esencial para los desarrolladores que construyen aplicaciones modernas impulsadas por datos.
Para usar IronPDF en tu proyecto, sigue estos pasos:
La interfaz IEnumerable representa una secuencia de elementos que se pueden enumerar. Los ejemplos comunes incluyen arreglos, listas y resultados de consultas LINQ. Al aprovechar LINQ, puedes filtrar, ordenar y proyectar datos en el formato deseado antes de generar PDFs con IronPDF.
Una de las principales ventajas de IEnumerable es su modelo de ejecución diferida, que permite que las consultas se ejecuten solo cuando se accede a sus resultados. Esto permite una manipulación eficiente de datos y reduce la carga computacional en flujos de trabajo complejos.
Dado que una lista implementa IEnumerable, cualquier colección, como List, puede tratarse como un IEnumerable, permitiendo operaciones LINQ fáciles, filtrado y transformación.
Imagina que tienes una lista que implementa IEnumerable de empleados que necesitas exportar como una tabla PDF. Usando IEnumerable e IronPDF, puedes iterar a través de los datos y convertirlos en un PDF bien estructurado.
Para mejorar la presentación, puedes usar tablas HTML con CSS en línea para estilizar las filas y columnas dinámicamente basándote en los datos. Esto asegura que la salida PDF sea tanto funcional como visualmente atractiva.
Con LINQ, puedes filtrar y transformar tus datos antes de pasarlos a IronPDF. Por ejemplo, podrías filtrar solo empleados activos y formatear sus nombres en mayúsculas para la salida del PDF.
var activeEmployees = employees.Where(e => e.IsActive).Select(e => new {
Name = e.Name.ToUpper(),
Position = e.Position,
Age = e.Age
});Dim activeEmployees = employees.Where(Function(e) e.IsActive).Select(Function(e) New With {
Key .Name = e.Name.ToUpper(),
Key .Position = e.Position,
Key .Age = e.Age
})Estos datos transformados pueden luego convertirse en un formato HTML apto para PDF para la representación.
Si necesitas generar un PDF separado para cada registro en una colección, puedes usar un bucle foreach para iterar a través del enumerable y generar PDFs individuales dinámicamente. Esto es particularmente útil para crear facturas, certificados o informes personalizados.
foreach (var employee in employees)
{
string html = $"<h1>{employee.Name}</h1><p>Position: {employee.Position}</p><p>Age: {employee.Age}</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs($"{employee.Name}_Report.pdf");
}For Each employee In employees
Dim html As String = $"<h1>{employee.Name}</h1><p>Position: {employee.Position}</p><p>Age: {employee.Age}</p>"
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs($"{employee.Name}_Report.pdf")
Next employeeEn C#, los métodos de extensión son una forma poderosa de agregar funcionalidad a tipos existentes sin modificar su código fuente. Puedes crear un método de extensión para agilizar operaciones en un IEnumerable o List.
Por ejemplo, vamos a crear un método de extensión para obtener el primer elemento de una colección enumerable.
public static class EnumerableExtensions
{
public static T FirstOrDefaultElement<t>(this IEnumerable<t> collection)
{
return collection?.FirstOrDefault();
}
}Imports System.Collections.Generic
Imports System.Linq
Public Module EnumerableExtensions
<System.Runtime.CompilerServices.Extension>
Public Function FirstOrDefaultElement(Of T)(collection As IEnumerable(Of T)) As T
Return If(collection?.FirstOrDefault(), Nothing)
End Function
End ModuleComienza configurando tu proyecto e inicializando IronPDF y la clase ChromePdfRenderer:
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();Imports IronPdf
Private renderer As New ChromePdfRenderer()Prepara tus datos enumerable como una cadena HTML:
var employees = new List<Employee>
{
new Employee { Name = "John Doe", Position = "Developer", Age = 30 },
new Employee { Name = "Jane Smith", Position = "Designer", Age = 25 }
};
string html = "<table style='width:100%; border: 1px solid black;'>" +
"<tr><th>Name</th><th>Position</th><th>Age</th></tr>";
foreach (var employee in employees)
{
html += $"<tr><td>{employee.Name}</td><td>{employee.Position}</td><td>{employee.Age}</td></tr>";
}
html += "</table>";Dim employees = New List(Of Employee) From {
New Employee With {
.Name = "John Doe",
.Position = "Developer",
.Age = 30
},
New Employee With {
.Name = "Jane Smith",
.Position = "Designer",
.Age = 25
}
}
Dim html As String = "<table style='width:100%; border: 1px solid black;'>" & "<tr><th>Name</th><th>Position</th><th>Age</th></tr>"
For Each employee In employees
html &= $"<tr><td>{employee.Name}</td><td>{employee.Position}</td><td>{employee.Age}</td></tr>"
Next employee
html &= "</table>"Convierte el HTML a un PDF:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("Employees.pdf");Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("Employees.pdf")Ahora que hemos echado un vistazo más de cerca a cómo puedes usar la clase C# Enumerable con IronPDF para generar archivos PDF, veamos un ejemplo de código completo en el que hemos utilizado estas herramientas para generar un nuevo documento PDF dinámico.
using System;
using System.Collections.Generic;
using System.Linq;
using IronPdf;
public class Employee
{
public string Name { get; set; }
public string Position { get; set; }
public int Age { get; set; }
}
public class Program
{
public static void Main(string[] args)
{
// Sample employee data
var employees = new List<Employee>
{
new Employee { Name = "John Doe", Position = "Developer", Age = 30 },
new Employee { Name = "Jane Smith", Position = "Designer", Age = 25 },
new Employee { Name = "Sam Wilson", Position = "Manager", Age = 35 }
};
// Filter and sort data using LINQ
var filteredEmployees = employees
.Where(e => e.Age >= 25)
.OrderBy(e => e.Name)
.ToList();
// Generate HTML for the PDF
string html = "<h1 style='text-align:center;'>Employee Report</h1>" +
"<table style='width:100%; border-collapse: collapse;'>" +
"<tr style='background-color: #f2f2f2;'>" +
"<th style='border: 1px solid black; padding: 8px;'>Name</th>" +
"<th style='border: 1px solid black; padding: 8px;'>Position</th>" +
"<th style='border: 1px solid black; padding: 8px;'>Age</th></tr>";
foreach (var employee in filteredEmployees)
{
html += $"<tr>" +
$"<td style='border: 1px solid black; padding: 8px;'>{employee.Name}</td>" +
$"<td style='border: 1px solid black; padding: 8px;'>{employee.Position}</td>" +
$"<td style='border: 1px solid black; padding: 8px;'>{employee.Age}</td>" +
$"</tr>";
}
html += "</table>";
// Initialize ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Render the HTML to a PDF
try
{
var pdf = renderer.RenderHtmlAsPdf(html);
string outputPath = "EmployeeReport.pdf";
pdf.SaveAs(outputPath);
Console.WriteLine($"PDF generated successfully at: {outputPath}");
}
catch (Exception ex)
{
Console.WriteLine($"Error generating PDF: {ex.Message}");
}
}
}Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports IronPdf
Public Class Employee
Public Property Name() As String
Public Property Position() As String
Public Property Age() As Integer
End Class
Public Class Program
Public Shared Sub Main(ByVal args() As String)
' Sample employee data
Dim employees = New List(Of Employee) From {
New Employee With {
.Name = "John Doe",
.Position = "Developer",
.Age = 30
},
New Employee With {
.Name = "Jane Smith",
.Position = "Designer",
.Age = 25
},
New Employee With {
.Name = "Sam Wilson",
.Position = "Manager",
.Age = 35
}
}
' Filter and sort data using LINQ
Dim filteredEmployees = employees.Where(Function(e) e.Age >= 25).OrderBy(Function(e) e.Name).ToList()
' Generate HTML for the PDF
Dim html As String = "<h1 style='text-align:center;'>Employee Report</h1>" & "<table style='width:100%; border-collapse: collapse;'>" & "<tr style='background-color: #f2f2f2;'>" & "<th style='border: 1px solid black; padding: 8px;'>Name</th>" & "<th style='border: 1px solid black; padding: 8px;'>Position</th>" & "<th style='border: 1px solid black; padding: 8px;'>Age</th></tr>"
For Each employee In filteredEmployees
html &= $"<tr>" & $"<td style='border: 1px solid black; padding: 8px;'>{employee.Name}</td>" & $"<td style='border: 1px solid black; padding: 8px;'>{employee.Position}</td>" & $"<td style='border: 1px solid black; padding: 8px;'>{employee.Age}</td>" & $"</tr>"
Next employee
html &= "</table>"
' Initialize ChromePdfRenderer
Dim renderer As New ChromePdfRenderer()
' Render the HTML to a PDF
Try
Dim pdf = renderer.RenderHtmlAsPdf(html)
Dim outputPath As String = "EmployeeReport.pdf"
pdf.SaveAs(outputPath)
Console.WriteLine($"PDF generated successfully at: {outputPath}")
Catch ex As Exception
Console.WriteLine($"Error generating PDF: {ex.Message}")
End Try
End Sub
End Class
Este programa de C# está diseñado para generar un informe PDF de datos de empleados filtrados utilizando la biblioteca IronPDF. El código anterior comienza definiendo una clase Empleado con propiedades para Nombre, Posición y Edad, representando registros individuales de empleados.
Se crea una lista de datos de empleados de muestra, que consiste en tres objetos Empleado con diferentes nombres, posiciones y edades. El programa luego usa LINQ para filtrar esta lista, seleccionando solo empleados de 25 años o más, y los ordena alfabéticamente por nombre. Esta lista filtrada y ordenada se almacena en la variable filteredEmployees.
A continuación, el programa construye una cadena HTML que se usará para generar el PDF. Comienza con un encabezado y una estructura de tabla, definiendo encabezados de columna para Nombre, Posición y Edad. Luego recorre la lista de empleados filtrados, generando dinámicamente filas de tabla para la información de cada empleado. El HTML resultante se utiliza para crear un PDF a través del ChromePdfRenderer de IronPDF.
El ejemplo anterior demuestra efectivamente cómo usar IronPDF para generar un PDF a partir de HTML generado dinámicamente, mostrando el poder de LINQ para filtrar y ordenar datos, y manejando excepciones de manera elegante durante el proceso de generación de PDF.
Usa LINQ para optimizar el filtrado y las transformaciones en tus datos. Por ejemplo:
var filteredEmployees = employees.Where(e => e.Age > 25).OrderBy(e => e.Name);Dim filteredEmployees = employees.Where(Function(e) e.Age > 25).OrderBy(Function(e) e.Name)Minimiza las operaciones redundantes encadenando efectivamente métodos LINQ. Esto mejora el rendimiento, especialmente cuando se trabaja con grandes conjuntos de datos.
Para grandes conjuntos de datos, considera transmitir datos en trozos más pequeños para evitar la sobrecarga de memoria. Utilice yield return para generar colecciones de manera diferida, asegurando un uso eficiente de la memoria.
IEnumerable<Employee> GetEmployees()
{
foreach (var employee in database.GetAllEmployees())
{
yield return employee;
}
}Private Iterator Function GetEmployees() As IEnumerable(Of Employee)
For Each employee In database.GetAllEmployees()
Yield employee
Next employee
End FunctionEnvuelve tu lógica de generación de PDF en un bloque try-catch para manejar errores de manera elegante:
try
{
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
catch (IronPdf.Exceptions.PdfException ex)
{
Console.WriteLine($"PDF Error: {ex.Message}");
}
catch (Exception ex)
{
Console.WriteLine($"General Error: {ex.Message}");
}Try
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
Catch ex As IronPdf.Exceptions.PdfException
Console.WriteLine($"PDF Error: {ex.Message}")
Catch ex As Exception
Console.WriteLine($"General Error: {ex.Message}")
End TryRegistrar errores y proporcionar retroalimentación amigable al usuario puede mejorar significativamente la robustez de tu aplicación.
La integración de IEnumerable de C# con IronPDF desbloquea una forma eficiente y flexible de generar PDFs profesionales de manera programática. Aprovechando IEnumerable, puedes agilizar la transformación y el formateo de datos mientras aprovechas el rico conjunto de funciones de IronPDF para producir documentos de alta calidad. Ya sea que estés exportando informes de datos, creando facturas, o generando contenido personalizado, esta combinación asegura escalabilidad, rendimiento y facilidad de uso.
Animamos a los desarrolladores a explorar características más avanzadas de IronPDF, como la incrustación de multimedia o la seguridad de PDFs, para elevar aún más sus flujos de trabajo de automatización de documentos. Para más información, tutoriales y soporte, consulta la Documentación de IronPDF.
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.
