快捷導(dǎo)航

C#使用Spire.XLS實現(xiàn)Excel到CSV的轉(zhuǎn)換與導(dǎo)出功能

更新時間：2025年09月10日 08:26:42 作者：缺點內(nèi)向

面對海量的Excel數(shù)據(jù),如何高效地進行自動化讀取和格式轉(zhuǎn)換,尤其是將其導(dǎo)出為輕量級的CSV格式,是許多C#開發(fā)者在企業(yè)數(shù)據(jù)處理中面臨的挑戰(zhàn),本文將為您提供一個詳細的C#教程,利用 Spire.XLS實現(xiàn)Excel數(shù)據(jù)的自動化讀取與高效的CSV導(dǎo)出,需要的朋友可以參考下

引言

面對海量的Excel數(shù)據(jù)，如何高效地進行自動化讀取和格式轉(zhuǎn)換，尤其是將其導(dǎo)出為輕量級的CSV格式，是許多C#開發(fā)者在企業(yè)數(shù)據(jù)處理、報表分析或數(shù)據(jù)遷移等場景中面臨的挑戰(zhàn)。手動操作不僅效率低下，還極易出錯。幸運的是，借助專業(yè)的.NET組件庫，我們可以輕松實現(xiàn)這一目標。

本文將為您提供一個詳細的C#教程，利用 Spire.XLS 這一強大的工具，實現(xiàn)Excel數(shù)據(jù)的自動化讀取與高效的CSV導(dǎo)出，助您告別繁瑣的手動操作，邁向數(shù)據(jù)處理自動化。

1. Spire.XLS簡介與環(huán)境準備

Spire.XLS 是一款專為.NET平臺設(shè)計的Excel組件庫，它允許開發(fā)者在C#、VB.NET等語言中輕松地創(chuàng)建、讀取、編輯、轉(zhuǎn)換和打印Excel文件，而無需依賴Microsoft Office。其核心優(yōu)勢在于：

易用性：提供直觀的API接口，降低開發(fā)難度。
高性能：優(yōu)化了處理大文件的效率，確保數(shù)據(jù)處理的流暢性。
功能豐富：支持Excel的幾乎所有特性，包括單元格樣式、公式、圖表、數(shù)據(jù)透視表等。
獨立性：無需安裝Microsoft Office即可運行，非常適合服務(wù)器端應(yīng)用。

環(huán)境搭建：

在您的Visual Studio項目中，通過NuGet包管理器安裝 Spire.XLS 庫是首選方式。

打開Visual Studio。
在“解決方案資源管理器”中，右鍵點擊您的項目，選擇“管理NuGet程序包”。
在“瀏覽”選項卡中，搜索 Spire.XLS。
選擇 Spire.XLS 包并點擊“安裝”。

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

2. C#讀取Excel數(shù)據(jù)核心步驟

使用Spire.XLS讀取Excel數(shù)據(jù)非常直觀。以下代碼演示了如何加載一個Excel文件，遍歷其工作表，并提取所有單元格的數(shù)據(jù)。

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
        {
            // 創(chuàng)建Workbook對象并加載Excel文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(filePath);

            // 獲取指定索引的工作表，這里默認獲取第一個工作表
            Worksheet sheet = workbook.Worksheets[sheetIndex];

            // 遍歷行和列，提取單元格數(shù)據(jù)
            for (int r = 1; r <= sheet.LastRow; r++) // 從第一行開始（通常是數(shù)據(jù)行）
            {
                List<string> rowData = new List<string>();
                for (int c = 1; c <= sheet.LastColumn; c++) // 從第一列開始
                {
                    // 獲取單元格值，ToString()處理可能存在的空值或不同數(shù)據(jù)類型
                    rowData.Add(sheet.Range[r, c].Text); 
                }
                data.Add(rowData.ToArray());
            }
            return data;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"讀取Excel文件時發(fā)生錯誤: {ex.Message}");
            return null;
        }
    }
}

代碼解析：

Workbook workbook = new Workbook();：創(chuàng)建一個Workbook實例。
workbook.LoadFromFile(filePath);：加載指定的Excel文件。
Worksheet sheet = workbook.Worksheets[sheetIndex];：通過索引獲取工作表，sheetIndex默認為0，即第一個工作表。
sheet.LastRow 和 sheet.LastColumn：獲取工作表的最后一行和最后一列的索引，用于遍歷。
sheet.Range[r, c].Text：獲取指定行和列的單元格文本內(nèi)容。

注意事項：在實際應(yīng)用中，您可能需要處理空單元格、數(shù)據(jù)類型轉(zhuǎn)換（例如將文本轉(zhuǎn)換為數(shù)字或日期）以及根據(jù)表頭跳過首行等情況。上述代碼中的Text屬性會返回單元格的顯示文本，適用于大多數(shù)導(dǎo)出場景。

3. C#將數(shù)據(jù)導(dǎo)出為CSV文件

在從Excel中讀取數(shù)據(jù)到內(nèi)存（List<string[]>）之后，將其導(dǎo)出為CSV文件就變得非常簡單。以下代碼演示了如何將內(nèi)存中的數(shù)據(jù)寫入CSV文件，并處理分隔符和編碼。

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("沒有數(shù)據(jù)可供導(dǎo)出。");
            return;
        }

        if (encoding == null)
        {
            encoding = Encoding.UTF8; // 默認使用UTF-8編碼
        }

        try
        {
            using (StreamWriter sw = new StreamWriter(outputPath, false, encoding))
            {
                foreach (string[] row in data)
                {
                    // 使用逗號作為分隔符連接單元格數(shù)據(jù)
                    // 對于包含逗號或換行符的數(shù)據(jù)，通常需要用雙引號包裹
                    // 這里簡化處理，直接Join，實際可根據(jù)需求進行更復(fù)雜的CSV格式化
                    sw.WriteLine(string.Join(delimiter, row)); 
                }
            }
            Console.WriteLine($"數(shù)據(jù)已成功導(dǎo)出到: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"導(dǎo)出CSV文件時發(fā)生錯誤: {ex.Message}");
        }
    }
}

代碼解析：

StreamWriter sw = new StreamWriter(outputPath, false, encoding)：創(chuàng)建一個StreamWriter實例，用于寫入文件。false表示如果文件存在則覆蓋，encoding指定文件編碼，推薦使用Encoding.UTF8以支持多語言字符。
string.Join(delimiter, row)：將每行的數(shù)據(jù)數(shù)組用指定的分隔符連接成一個字符串。
sw.WriteLine(...)：將拼接好的行數(shù)據(jù)寫入CSV文件，并添加換行符。

進階提示：對于包含逗號、雙引號或換行符等特殊字符的單元格內(nèi)容，標準的CSV格式要求使用雙引號將這些字段包裹起來。string.Join在此處進行了簡化處理，在生產(chǎn)環(huán)境中，您可能需要實現(xiàn)一個更健壯的CSV格式化函數(shù)，例如檢查每個字段是否需要加引號，并對內(nèi)部的雙引號進行轉(zhuǎn)義（""）。