Spire.XLS实战教程：轻松实现Excel到CSV的转换与导出

面对海量的Excel数据，如何高效地进行自动化读取和格式转换，尤其是将其导出为轻量级的CSV格式，是许多C#开发者在企业数据处理、报表分析或数据迁移等场景中面临的挑战。手动操作不仅效率低下，还极易出错。幸运的是，借助专业的.NET组件库，我们可以轻松实现这一目标。

本文将为您提供一个详细的C#教程，利用 Spire.XLS 这一强大的工具，实现Excel数据的自动化读取与高效的CSV导出，助您告别繁琐的手动操作，迈向数据处理自动化。

1. Spire.XLS简介与环境准备

Spire.XLS 是一款专为.NET平台设计的Excel组件库，它允许开发者在C#、VB.NET等语言中轻松地创建、读取、编辑、转换和打印Excel文件，而无需依赖Microsoft Office。其核心优势在于：

易用性：提供直观的API接口，降低开发难度。
高性能：优化了处理大文件的效率，确保数据处理的流畅性。
功能丰富：支持Excel的几乎所有特性，包括单元格样式、公式、图表、数据透视表等。
独立性：无需安装Microsoft Office即可运行，非常适合服务器端应用。

环境搭建：

在您的Visual Studio项目中，通过NuGet包管理器安装 Spire.XLS 库是首选方式。

打开Visual Studio。
在"解决方案资源管理器"中，右键点击您的项目，选择"管理NuGet程序包"。
在"浏览"选项卡中，搜索 Spire.XLS。
选择 Spire.XLS 包并点击"安装"。

本文示例代码适用于.NET Framework 4.6.1及以上版本，或.NET Core 2.1及以上版本。

2. C#读取Excel数据核心步骤

使用Spire.XLS读取Excel数据非常直观。以下代码演示了如何加载一个Excel文件，遍历其工作表，并提取所有单元格的数据。

csharp 复制代码

using Spire.Xls;
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;

public class ExcelDataReader
{
    public static List<string[]> ReadExcelData(string filePath, int sheetIndex = 0)
    {
        List<string[]> data = new List<string[]>();
        try
        {
            // 创建Workbook对象并加载Excel文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(filePath);

            // 获取指定索引的工作表，这里默认获取第一个工作表
            Worksheet sheet = workbook.Worksheets[sheetIndex];

            // 遍历行和列，提取单元格数据
            for (int r = 1; r <= sheet.LastRow; r++) // 从第一行开始（通常是数据行）
            {
                List<string> rowData = new List<string>();
                for (int c = 1; c <= sheet.LastColumn; c++) // 从第一列开始
                {
                    // 获取单元格值，ToString()处理可能存在的空值或不同数据类型
                    rowData.Add(sheet.Range[r, c].Text); 
                }
                data.Add(rowData.ToArray());
            }
            return data;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"读取Excel文件时发生错误: {ex.Message}");
            return null;
        }
    }
}

代码解析：

Workbook workbook = new Workbook();：创建一个Workbook实例。
workbook.LoadFromFile(filePath);：加载指定的Excel文件。
Worksheet sheet = workbook.Worksheets[sheetIndex];：通过索引获取工作表，sheetIndex默认为0，即第一个工作表。
sheet.LastRow 和 sheet.LastColumn：获取工作表的最后一行和最后一列的索引，用于遍历。
sheet.Range[r, c].Text：获取指定行和列的单元格文本内容。

注意事项 ：在实际应用中，您可能需要处理空单元格、数据类型转换（例如将文本转换为数字或日期）以及根据表头跳过首行等情况。上述代码中的Text属性会返回单元格的显示文本，适用于大多数导出场景。

3. C#将数据导出为CSV文件

在从Excel中读取数据到内存（List<string[]>）之后，将其导出为CSV文件就变得非常简单。以下代码演示了如何将内存中的数据写入CSV文件，并处理分隔符和编码。

csharp 复制代码

public class CsvExporter
{
    public static void ExportToCsv(List<string[]> data, string outputPath, string delimiter = ",", Encoding encoding = null)
    {
        if (data == null || data.Count == 0)
        {
            Console.WriteLine("没有数据可供导出。");
            return;
        }

        if (encoding == null)
        {
            encoding = Encoding.UTF8; // 默认使用UTF-8编码
        }

        try
        {
            using (StreamWriter sw = new StreamWriter(outputPath, false, encoding))
            {
                foreach (string[] row in data)
                {
                    // 使用逗号作为分隔符连接单元格数据
                    // 对于包含逗号或换行符的数据，通常需要用双引号包裹
                    // 这里简化处理，直接Join，实际可根据需求进行更复杂的CSV格式化
                    sw.WriteLine(string.Join(delimiter, row)); 
                }
            }
            Console.WriteLine($"数据已成功导出到: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"导出CSV文件时发生错误: {ex.Message}");
        }
    }
}

代码解析：

StreamWriter sw = new StreamWriter(outputPath, false, encoding)：创建一个StreamWriter实例，用于写入文件。false表示如果文件存在则覆盖，encoding指定文件编码，推荐使用Encoding.UTF8以支持多语言字符。
string.Join(delimiter, row)：将每行的数据数组用指定的分隔符连接成一个字符串。
sw.WriteLine(...)：将拼接好的行数据写入CSV文件，并添加换行符。

进阶提示 ：对于包含逗号、双引号或换行符等特殊字符的单元格内容，标准的CSV格式要求使用双引号将这些字段包裹起来。string.Join在此处进行了简化处理，在生产环境中，您可能需要实现一个更健壮的CSV格式化函数，例如检查每个字段是否需要加引号，并对内部的双引号进行转义（""）。

结论

Spire.XLS作为一款强大的.NET Excel组件库，极大地简化了Excel数据处理的复杂性，为C#开发者在自动化数据处理、系统集成和报表生成等领域提供了坚实的基础。