已更新 2026年4月23日
简化 .NET 与 Microsoft.Extensions.AI 的 LLM 集成
AI正在改变软件开发，但将大型语言模型（LLM）集成到.NET中直到现在一直很复杂。通过IronPdf.AI，将AI集成更进一步，该产品为.NET应用程序带来了OpenAI驱动的PDF解析、数据提取和内容摘要。
阅读更多
开发者更新
C# Enumerable（开发者用法）
Jacob Mellor
Updated: 2026年4月21日
C#的IEnumerable接口是.NET框架中最通用的工具之一，使开发人员可以以高度灵活的方式处理集合。 当与IronPDF结合使用时，IEnumerable允许动态数据操作和高效的PDF生成，非常适合创建报告、导出数据或从数据库查询生成文档的场景。
使用IEnumerable确保您的应用程序保持可扩展性和内存效率，因为它以惰性方式处理数据，避免一次性加载整个数据集到内存。 这对于处理大量数据集合的大规模应用尤其有用，例如一个庞大的数据库表。
什么是 IronPDF？
IronPDF是一个强大的.NET库，旨在简化以编程方式创建、编辑和管理PDF文件的过程。 它提供了广泛的功能，包括HTML到PDF的转换、文本提取、PDF合并等。 通过将IronPDF集成到您的C#项目中，您可以高效地处理复杂的PDF任务，而无需深入了解PDF内部。
IronPDF还支持多种格式，允许您从原始HTML、Razor视图、ASP.NET网页或甚至直接从数据结构生成PDF。 这种灵活性使其成为构建现代数据驱动应用程序的开发人员的必备工具。
开始
安装 IronPDF
要在项目中使用IronPDF，请遵循以下步骤：
通过NuGet包管理器控制台
- 在Visual Studio中打开您的.NET项目。
- 在工具下拉菜单中打开NuGet包管理器控制台。
- 运行以下命令：
通过解决方案的NuGet包管理器
- 在您的Visual Studio项目中，转到工具 > NuGet包管理器 > 管理解决方案的NuGet包。
- 搜索IronPDF。
- 点击"安装"以开始将IronPDF包安装到您的项目中。
Basic Concepts of Enumerable in C#
IEnumerable接口表示一个可以枚举的元素序列。 常见的例子包括数组、列表和LINQ查询结果。 通过利用LINQ，您可以在生成PDF之前将数据过滤、排序和投影为期望的格式。
IEnumerable的一个关键优势是其延迟执行模型，允许查询只在访问结果时执行。 这使得数据操作更高效，并减少了复杂工作流中的计算开销。
由于列表实现了IEnumerable，任何集合，比如List，都可以作为IEnumerable进行处理，从而实现易于使用的LINQ操作、过滤和转换。
实际用例
从Enumerable数据生成PDF
示例：导出对象列表到PDF表格
假设您有一个实现了IEnumerable的员工列表，您需要将其导出为PDF表格。 使用IEnumerable和IronPDF，您可以遍历数据并将其转换为结构良好的PDF。
为了增强展示，您可以使用带有内联CSS的HTML表格，根据数据动态设置行和列的样式。 这确保PDF输出既实用又视觉美观。
在PDF生成前过滤和转换数据
示例：使用LINQ选择和格式化数据
使用LINQ，您可以在将数据传递给IronPDF之前对其进行过滤和转换。 例如，您可以仅过滤活动员工，并将他们的名字格式化为大写以用于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
})然后可以将此转换后的数据转换为适合PDF渲染的HTML格式。
从枚举集合批量生成PDF
示例：从集合中创建多个PDF
如果需要为集合中的每个记录生成单独的PDF，您可以使用foreach循环遍历枚举并动态生成各个PDF。 这对于创建发票、证书或个性化报告特别有用。
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 employee枚举扩展方法
在C#中，扩展方法是一种强大方式，可以在不修改源代码的情况下为现有类型添加功能。 您可以创建扩展方法来简化IEnumerable或List上的操作。
例如，让我们创建一个扩展方法来获取枚举集合中的第一个元素。
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 Module逐步实现
项目设置
Code Snippet: Initializing IronPDF in C#
首先设置您的项目并初始化IronPDF和ChromePdfRenderer类：
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();Imports IronPdf
Private renderer As New ChromePdfRenderer()将枚举转换为PDF内容
代码片段：迭代和格式化数据到HTML
将您的枚举数据准备为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>"代码片段：将HTML渲染为PDF
将HTML转换为PDF：
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("Employees.pdf");Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("Employees.pdf")完整代码示例
现在我们已经仔细了解了如何使用C#的Enumerable类与IronPDF一起生成PDF文件，让我们看看一个完整的示例代码，其中我们使用这些工具生成一个新的动态PDF文档。
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输出PDF
代码解释
这个C#程序旨在使用IronPDF库生成过滤后的员工数据的PDF报告。 上面的代码首先定义了一个Employee类，其属性包括Name、Position和Age，表示单个员工记录。
创建了一个包含三个Employee对象的示例员工数据列表，这些对象具有不同的名称、职位和年龄。 然后该程序使用LINQ过滤此列表，仅选择年龄在25岁或以上的员工，并按名称字母顺序排序。 将此过滤后和排序的列表存储在filteredEmployees变量中。
接下来，程序构建一个HTML字符串，该字符串将用于生成PDF。 它以标题和表格结构开始，定义了Name、Position和Age的列头。 然后通过循环遍历过滤后的员工列表，为每个员工的信息动态生成表格行。 生成的HTML用于通过IronPDF的ChromePdfRenderer创建PDF。
上面的示例有效地演示了如何使用IronPDF从动态生成的HTML生成PDF，展示了LINQ在过滤和排序数据方面的强大功能，并在PDF生成过程中优雅地处理异常。
性能提示和最佳实践
优化Enumerable操作
使用LINQ优化数据的过滤和转换。 例如：
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)通过有效地链接LINQ方法来减少冗余操作。 这提高了性能，尤其是在处理大型数据集时。
大数据集的高效内存使用
对于大型数据集，考虑将数据流分成较小的块以避免内存负载。 利用yield return来惰性生成集合，确保高效的内存使用。
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 FunctionPDF生成中的错误处理
将您的PDF生成逻辑包装在try-catch块中以优雅地处理错误：
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 Try记录错误并提供用户友好的反馈可以显著提高应用程序的稳健性。
结论
C#的IEnumerable与IronPDF的集成释放了一种高效灵活的方式，用以以编程方式生成专业的PDF。 通过利用IEnumerable，您可以简化数据的转换和格式化，同时利用IronPDF丰富的功能集生成高质量文档。 无论您是在导出数据报告、创建发票，还是生成个性化内容，这种组合都确保了可扩展性、性能和易用性。
我们鼓励开发者探索IronPDF的更多高级功能，比如嵌入多媒体或保护PDF，以进一步提高他们的文档自动化工作流程。 有关更多的见解、教程和支持，请参阅IronPDF文档。
首席技术官
Jacob Mellor 是 Iron Software 的首席技术官，也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者，他从公司成立之初就开始塑造公司的产品架构，与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司，为 NASA、特斯拉和全球政府机构提供服务。
相关文章
当您需要PDF看起来像HTML时，速度快。
