信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF博客
  3. .NET幫助
  4. C# Enumerable
.NET幫助

C# Enumerable（它如何對開發者起作用）

Curtis Chau
Curtis Chau
更新日期:

C# 的 IEnumerable 接口是 .NET 架构中最通用的工具之一，使开发人员能够以高度灵活的方式处理集合。 当与 IronPDF 结合使用时，IEnumerable 允许动态数据处理和高效的 PDF 生成，使其非常适合创建报告、导出数据或从数据库查询生成文档等场景。

使用 IEnumerable 可确保您的应用程序保持可扩展性和内存效率，因为它以延迟方式处理数据，避免一次性加载整个数据集到内存中。 这对于处理大量数据集合的大规模应用程序特别有用，比如一个庞大的数据库表。

什麼是 IronPDF？

C# Enumerable （开发人员如何使用）: 图1

IronPDF 是一个强大的 .NET 库，旨在简化以编程方式创建、编辑和管理 PDF 文件的过程。 它提供了一系列广泛的功能，包括 HTML 到 PDF 转换、文本提取、PDF 合并等。 通过将 IronPDF 集成到您的 C# 项目中，您可以有效地处理复杂的 PDF 任务，而无需深入了解 PDF 内部。

IronPDF 还支持各种格式，允许您从原始 HTML、Razor 视图、ASP.NET 网页，甚至直接从数据结构生成 PDF。 这种灵活性使其成为开发人员构建现代数据驱动应用程序的重要工具。

入門指南

安裝 IronPDF

要在项目中使用 IronPDF，请按照以下步骤操作：

通过 NuGet 包管理器控制台

  1. 在 Visual Studio 中打开您的 .NET 项目。
  2. 在工具下拉菜单中打开 NuGet 包管理器控制台。

C# Enumerable （开发人员如何使用）: 图2

  1. 运行以下命令：
Install-Package IronPdf

通过解决方案的 NuGet 包管理器

  1. 在您的 Visual Studio 项目中，转到工具 > NuGet 包管理器 > 管理解决方案的 NuGet 包。
  2. 搜索 IronPDF。

C# Enumerable （开发人员如何使用）: 图3

  1. 点击“安装”以开始在您的项目中安装 IronPDF 包。

C# Enumerable （开发人员如何使用）: 图4

C# 中 Enumerable 的基本概念

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
});
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
})
$vbLabelText   $csharpLabel

然后可以将这些转换后的数据转换为 PDF 友好的 HTML 格式进行渲染。

从可枚举对象批量生成 PDF

示例：从集合创建多个 PDF

如果您需要为集合中的每个记录生成单独的 PDF，可以使用 foreach 循环遍历 enumerable 并动态生成单独的 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");
}
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
$vbLabelText   $csharpLabel

Enumerable 的扩展方法

在 C# 中，扩展方法是一种无需修改源代码即可为现有类型添加功能的强大方式。 您可以创建扩展方法来简化 IEnumerable 或 List 上的操作。

例如，让我们创建一个扩展方法来获取 enumerable 集合中的第一个元素。

public static class EnumerableExtensions
{
    public static T FirstOrDefaultElement<T>(this IEnumerable<T> collection)
    {
        return collection?.FirstOrDefault();
    }
}
public static class EnumerableExtensions
{
    public static T FirstOrDefaultElement<T>(this IEnumerable<T> collection)
    {
        return collection?.FirstOrDefault();
    }
}
Public Module EnumerableExtensions
	<System.Runtime.CompilerServices.Extension> _
	Public Function FirstOrDefaultElement(Of T)(ByVal collection As IEnumerable(Of T)) As T
		Return collection?.FirstOrDefault()
	End Function
End Module
$vbLabelText   $csharpLabel

逐步實施

設置項目

代码片段：在 C# 中初始化 IronPDF

从设置您的项目并初始化 IronPDF 和 ChromePdfRenderer 类开始：

using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
Imports IronPdf
Private renderer As New ChromePdfRenderer()
$vbLabelText   $csharpLabel

将可枚举对象转换为 PDF 内容

代码片段：迭代和格式化数据为 HTML

将您的 enumerable 数据准备为 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>";
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>"
$vbLabelText   $csharpLabel

代码片段：将 HTML 渲染为 PDF

将 HTML 转换为 PDF：

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("Employees.pdf");
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("Employees.pdf");
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("Employees.pdf")
$vbLabelText   $csharpLabel

完整代碼示例

现在我们已经深入了解了如何使用 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}");
        }
    }
}
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
$vbLabelText   $csharpLabel

輸出 PDF

C# Enumerable （开发人员如何使用）: 图5

代碼說明

这个 C# 程序旨在使用 IronPDF 库生成过滤后的雇员数据的 PDF 报告。 上面的代码首先定义了一个 Employee 类，其属性包括姓名、职位和年龄，代表个人员工记录。

创建了一个示例雇员数据的列表，由三个具有不同姓名、职位和年龄的 Employee 对象组成。 然后，程序使用 LINQ 过滤此列表，仅选择年龄在 25 岁或以上的员工，并按姓名字母顺序排序。 此经过过滤和排序的列表存储在 filteredEmployees 变量中。

接下来，程序构建了将用于生成 PDF 的 HTML 字符串。 它以一个标题和表结构开始，定义了姓名、职位和年龄的列标题。 然后循环遍历过滤后的员工名单，动态生成每位员工信息的表行。 生成的 HTML 被用来通过 IronPDF 的 ChromePdfRenderer 创建 PDF。

上述示例有效地展示了如何使用 IronPDF 从动态生成的 HTML 中生成 PDF，展示了 LINQ 在过滤和排序数据方面的强大功能，并在 PDF 生成过程中优雅地处理异常。

性能提示和最佳實踐

优化 Enumerable 操作

使用 LINQ 优化您的数据的过滤和转换。 例如：

var filteredEmployees = employees.Where(e => e.Age > 25).OrderBy(e => e.Name);
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)
$vbLabelText   $csharpLabel

通过有效地链接 LINQ 方法减少冗余操作。 这会提高性能，特别是在处理大数据集时。

大数据集的高效内存使用

对于大数据集，考虑将数据流化为较小的块以避免内存开销。 利用 yield return 以延迟方式生成集合，确保内存使用高效。

IEnumerable<Employee> GetEmployees()
{
    foreach (var employee in database.GetAllEmployees())
    {
        yield return employee;
    }
}
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 Function
$vbLabelText   $csharpLabel

PDF 生成中的错误处理

将您的 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
{
    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
$vbLabelText   $csharpLabel

记录错误并提供用户友好的反馈可以显著提高应用程序的稳健性。

結論

C# 的 IEnumerable 与 IronPDF 的集成打开了一种高效且灵活的方法，用于以编程方式生成专业的 PDF。 通过利用 IEnumerable，您可以简化数据的转换和格式化，同时利用 IronPDF 丰富的功能集生产高质量的文档。 无论您是在导出数据报告、创建发票，还是生成个性化内容，此组合都确保了可扩展性、性能和易用性。

我们鼓励开发人员探索 IronPDF 的更多高级功能，例如嵌入多媒体或保护 PDF，以进一步提升他们的文档自动化工作流。 有关更多见解、教程和支持，请参考 IronPDF 文档。

常見問題解答

IEnumerable如何促進C#中的動態數據操作？

C#中的IEnumerable允許開發人員靈活地遍歷集合以進行動態數據操作。與IronPDF結合使用時，它提供了一種有效的方法來操作數據以生成報告或將數據導出為PDF文檔。

使用IEnumerable的延遲數據處理有什麼好處？

使用IEnumerable的延遲數據處理可提高可擴展性和內存效率，因為它僅在需要時處理數據。這對於處理大型數據集特別有益，因為它避免了一次將整個數據集加載到內存中。

如何使用.NET庫在C#中將HTML轉換為PDF？

您可以使用IronPDF的RenderHtmlAsPdf方法將HTML字串轉換為PDF。此外，可以使用RenderHtmlFileAsPdf方法將HTML文件轉換為PDF。

IEnumerable在文檔生成中有什麼實際應用？

IEnumerable可用於將對象列表導出為PDF表格，在生成PDF之前進行數據過濾和轉換，並從集合中批量生成PDF，同時利用IronPDF的功能。

如何在C#項目中安裝IronPDF以生成PDF？

IronPDF可以通過在Visual Studio中使用NuGet包管理器控制台以命令Install-Package IronPdf在C#項目中安裝，或者通過在解決方案的NuGet包管理器中搜索IronPDF並點擊'Install'進行安裝。

ChromePdfRenderer類在PDF生成中扮演什麼角色？

IronPDF中的ChromePdfRenderer類對將HTML內容呈現為PDF格式至關重要，提供了一個核心功能來編程生成C#應用程序中的PDF。

如何在生成PDF之前使用LINQ優化數據？

LINQ可以與IEnumerable一起使用，以高效地過濾、排序並將數據投射為所需格式，然後將其傳遞給IronPDF進行PDF生成，從而實現流線型的文檔創建。

如何在C#應用程序中處理PDF生成中的錯誤？

使用IronPDF生成PDF時的錯誤可以使用try-catch塊來管理，這有助於優雅地處理錯誤和日誌記錄，從而提高應用程序的穩定性。

在使用IEnumerable進行高效數據處理時應遵循哪些最佳實踐？

最佳實踐包括使用LINQ優化數據轉換、最小化冗餘操作，以及利用'yield return'進行延遲數據生成以有效管理內存並提高性能。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用