如何使用 C# 将 HTML 表格导出到 Excel

IronXL为何适合企业环境？

IronXL擅长创建和操作Excel文件而无需安装Microsoft Office，这使其成为服务器环境和跨平台应用程序的理想选择。 该库支持部署到 Azure 、 AWS Lambda 函数和Docker 容器，确保与现代云架构兼容。 IronXL 与强大的 HTML 文件和内容解析器HTML Agility Pack配合使用时，就成为将任何 HTML 表格结构转换为 Excel 表格数据的多功能解决方案。 这种方法可以与.NET应用程序无缝协作，并通过优化的性能特性高效地处理大型数据集。

对于需要严格遵守规定的企业环境， IronXL提供全面的安全文档，并支持密码保护的工作簿和加密的工作表。 该库还可以在Linux 服务器和macOS 系统上无缝运行，提供真正的跨平台兼容性，这对于多样化的企业基础架构至关重要。

IronXL与其他 Excel 库相比如何？

与 Syncfusion Excel 库的 XlsIO 等库不同，后者提供的 ImportHtmlTable 函数仅限于特定的 HTML 格式和表格结构， IronXL方法使开发人员能够完全控制解析和转换过程。 这种灵活性意味着开发人员可以处理复杂的场景，例如嵌套表、自定义数据格式和选择性列提取，而这些是僵化的内置方法无法实现的。 默认设置适用于大多数使用场景，但您可以自定义每个细节，包括单元格字体和大小、背景图案和颜色以及边框对齐方式。

IronXL丰富的 API 参考为开发人员提供了对 Excel 操作各个方面的精细控制，从条件格式设置到图表创建。 这种控制水平在处理需要特定格式以满足监管合规性或公司标准的企业数据时尤为重要。

IronXL提供哪些高级功能？

此外， IronXL还提供全面的 Excel 功能，包括公式支持、单元格样式、多工作表管理以及各种导出格式（XLSX、XLS、 JSON和 CSV 文件）。 该库支持求和、平均值、最小值和最大值等数学函数，可以直接在生成的 Excel 文件中进行复杂的计算。 您甚至可以创建图表、导出为 PDF以及管理隐藏字段数据，使其成为满足 Excel 自动化需求的完整解决方案，而不仅仅是简单的 HTML 表格转换。 无论是处理DataTable 对象还是电子表格文件， IronXL都能无缝地处理转换。

对于企业报表需求， IronXL支持命名范围以提高公式可读性，冻结窗格以更好地进行数据导航，以及分组/取消分组功能以组织复杂的数据结构。 该库还提供自动调整大小功能，以确保所有内容都能正确显示。

需要哪些NuGet包？

首先，通过NuGet包管理器安装IronXL和HTML Agility Pack。 IronXL提供免费试用版，供用户测试所有功能，并为企业部署提供详细的许可文档：

Install-Package IronXl.Excel
Install-Package HtmlAgilityPack

Install-Package IronXl.Excel
Install-Package HtmlAgilityPack

对于企业环境，您可以在 Web.config 中配置许可证密钥，或者使用许可 API以编程方式应用它。 该库支持各种部署场景，包括ASP.NET Web 应用程序和Blazor服务器端应用程序。

我应该导入哪些命名空间？

这些NuGet包允许您以编程方式创建、加载和保存Excel 文档。 然后将必要的using语句导入您的C#代码文件：

using IronXL;
using HtmlAgilityPack;
using System;
using System.Linq;

using IronXL;
using HtmlAgilityPack;
using System;
using System.Linq;

这些库可以无缝协作，HTML Agility Pack 负责 HTML 解析，而IronXL负责Excel 文件的创建和操作。 本示例演示了一种将 HTML 表格转换为XLSX 格式的简单方法。 对于VB .NET开发人员来说，只需稍作语法调整即可实现类似的功能。

提取HTML表格内容的基本方法是什么？

HTML Agility Pack提供了一种简单的方法，通过XPath表达式导航HTML文档。 以下代码展示了如何使用IronXL 的数据导入功能从 HTML 表格中提取数据并准备导出：

// Sample HTML table with product data
string htmlContent = @"
<table>
    <thead>
        <tr>
            <th>Product</th>
            <th>Price</th>
            <th>Stock</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Laptop</td>
            <td>$999</td>
            <td>15</td>
        </tr>
        <tr>
            <td>Mouse</td>
            <td>$25</td>
            <td>50</td>
        </tr>
        <tr>
            <td>Keyboard</td>
            <td>$75</td>
            <td>30</td>
        </tr>
    </tbody>
</table>";
// Load HTML document for parsing
var doc = new HtmlDocument();
doc.LoadHtml(htmlContent);
// Select the HTML table element using XPath
var table = doc.DocumentNode.SelectSingleNode("//table");

// Sample HTML table with product data
string htmlContent = @"
<table>
    <thead>
        <tr>
            <th>Product</th>
            <th>Price</th>
            <th>Stock</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Laptop</td>
            <td>$999</td>
            <td>15</td>
        </tr>
        <tr>
            <td>Mouse</td>
            <td>$25</td>
            <td>50</td>
        </tr>
        <tr>
            <td>Keyboard</td>
            <td>$75</td>
            <td>30</td>
        </tr>
    </tbody>
</table>";
// Load HTML document for parsing
var doc = new HtmlDocument();
doc.LoadHtml(htmlContent);
// Select the HTML table element using XPath
var table = doc.DocumentNode.SelectSingleNode("//table");

这种解析方法适用于各种 HTML 源，无论是来自网络抓取、数据库导出还是动态生成的内容。 提取的数据可以使用 IronXL 的数据处理功能进行进一步处理，然后再导出。

XPath 如何用于表格元素选择？

这段代码将 HTML 内容加载到 HtmlDocument 对象中，并使用 XPath查询和选择表格元素。 SelectSingleNode 方法返回 HTML 中找到的第一个表格，方便在存在多个表格时定位特定表格。它会处理表格的每一行，提取单元格值进行转换，类似于 IronXL 处理 Excel 数据时的范围选择方式。

对于涉及合并单元格或重复行和列的更复杂场景，可能需要额外的解析逻辑来在转换过程中保持正确的结构。

什么代码可以将HTML表格数据转换为Excel格式？

使用IronXL，我们可以轻松地将解析的HTML表格数据转换为具有适当格式的专业Excel电子表格。 以下代码演示了如何使用自定义字体大小和字体系列设置导出数据：

// Create a new Excel workbook
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Exported Data");
// Extract and write headers
var headers = table.SelectNodes(".//thead/tr/th");
if (headers != null)
{
    for (int col = 0; col < headers.Count; col++)
    {
        workSheet.SetCellValue(0, col, headers[col].InnerText.Trim());
        // Apply header formatting
        var headerCell = workSheet.GetCellAt(0, col);
        headerCell.Style.Font.Bold = true;
        headerCell.Style.BackgroundColor = "#4CAF50";
    }
}
// Extract and write data rows
var rows = table.SelectNodes(".//tbody/tr");
if (rows != null)
{
    for (int row = 0; row < rows.Count; row++)
    {
        var cells = rows[row].SelectNodes("td");
        if (cells != null)
        {
            for (int col = 0; col < cells.Count; col++)
            {
                string cellValue = cells[col].InnerText.Trim();
                workSheet.SetCellValue(row + 1, col, cellValue);
            }
        }
    }
}
// Auto-fit columns for better readability
for (int col = 0; col < headers?.Count; col++)
{
    workSheet.AutoSizeColumn(col);
}
// Save the Excel file
workBook.SaveAs("ExportedTable.xlsx");

// Create a new Excel workbook
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Exported Data");
// Extract and write headers
var headers = table.SelectNodes(".//thead/tr/th");
if (headers != null)
{
    for (int col = 0; col < headers.Count; col++)
    {
        workSheet.SetCellValue(0, col, headers[col].InnerText.Trim());
        // Apply header formatting
        var headerCell = workSheet.GetCellAt(0, col);
        headerCell.Style.Font.Bold = true;
        headerCell.Style.BackgroundColor = "#4CAF50";
    }
}
// Extract and write data rows
var rows = table.SelectNodes(".//tbody/tr");
if (rows != null)
{
    for (int row = 0; row < rows.Count; row++)
    {
        var cells = rows[row].SelectNodes("td");
        if (cells != null)
        {
            for (int col = 0; col < cells.Count; col++)
            {
                string cellValue = cells[col].InnerText.Trim();
                workSheet.SetCellValue(row + 1, col, cellValue);
            }
        }
    }
}
// Auto-fit columns for better readability
for (int col = 0; col < headers?.Count; col++)
{
    workSheet.AutoSizeColumn(col);
}
// Save the Excel file
workBook.SaveAs("ExportedTable.xlsx");

可以通过添加数字格式、单元格注释或超链接等其他格式选项来增强此代码，从而创建更复杂的 Excel 输出。 对于大型数据集，请考虑使用IronXL 的性能优化功能来处理文件大小限制。

Excel API 结构如何运作？

此代码演示了 IronXL 的直观的C​​# Excel 操作API。 首先，它创建一个新的工作簿和工作表。 然后它遍历已解析的 HTML 表格标题，将它们放置在第一行，同时应用粗体格式和绿色背景色。 HTML表格中的数据行以类似的方式处理，每个单元格的文本内容被提取并放置在相应的Excel单元格中。 AutoSizeColumn函数确保所有内容都可见，最后，将工作簿保存为 XLSX 文件。 您可以轻松下载生成的文件，或将其存储在数据库中以便日后检索。

对于需要审计跟踪的企业场景，您可以添加工作簿元数据，例如作者信息、创建日期和文档属性。 该库还支持打印设置配置，用于生成可直接打印的报告。

最终输出是什么样的？

这里可以看到原始 HTML 表格与上述输出的对比，展示了IronXL如何在提供专业格式选项的同时保持数据完整性：

如何导出多个HTML表格？

当处理多个表格时，只需使用 SelectNodes("//table") 获取所有表格并遍历它们，为每个表格创建单独的工作表。 本示例展示了如何使用工作表管理技术处理包含大型数据集的复杂场景：

var tables = doc.DocumentNode.SelectNodes("//table");
foreach (var tbl in tables)
{
    // Create new worksheet for each table
    WorkSheet ws = workBook.CreateWorkSheet($"Table_{tables.IndexOf(tbl) + 1}");
    // Process table as shown above
}

var tables = doc.DocumentNode.SelectNodes("//table");
foreach (var tbl in tables)
{
    // Create new worksheet for each table
    WorkSheet ws = workBook.CreateWorkSheet($"Table_{tables.IndexOf(tbl) + 1}");
    // Process table as shown above
}

对于更高级的场景，您可以合并多个 Excel 区域、实施数据验证或添加条件格式规则来突出显示重要的数据模式。

我应该实现怎样的错误处理？

为了错误处理，将解析逻辑包在try-catch块中，以优雅地处理格式错误的HTML。 IronXL会自动处理数据类型检测，并在适当的时候使用其内置的转换功能将数字字符串转换为数字。 对于涉及动态内容的更复杂场景，开发人员通常将此方法与Selenium WebDriver等工具结合使用，以处理JavaScript渲染的表格。

在处理CSV 文件或TSV 数据时， IronXL提供了专门的方法来处理基于分隔符的格式。 该库还支持不同电子表格格式之间的转换，从而可以轻松导出为不同系统所需的格式。

如何处理特殊数据需求？

在处理来自 URL 或数据库查询的内容以进行进一步分析时，您可能需要处理其他细节，例如隐藏字段值或特殊格式要求。 默认行为对于标准表格效果很好，但您可以使用IronXL 的样式 API根据需要为每一列或任何特定的表格行自定义字体大小、字体系列和其他样式属性。

对于需要排序或修剪的数据， IronXL提供了内置方法，可以在最终导出之前清理和整理数据。 您还可以根据解析要求动态添加行和列，或者在处理过程中根据需要插入新的行和列。

企业应用程序经常需要导出为不同的格式，例如转换为 HTML以便在 Web 上显示，或者通过DataTable 转换与 SQL 数据库集成。 IronXL通过专门的方法和全面的文档支持所有这些场景。