C# 讀取 Excel 數據？Spire.XLS 助您輕鬆搞定！详情 - c#,excel 宇文成都日志

在現代企業應用中，Excel 文件扮演着至關重要的角色，無論是數據導入、報表生成、還是數據分析，都離不開對 Excel 數據的處理。對於 C# 開發者而言，如何高效、穩定地在應用程序中 C# 讀取 Excel 內容，常常是一個需要面對的挑戰。傳統方法可能需要依賴 Microsoft Office 的 COM 組件，這不僅增加了部署的複雜性，還可能面臨兼容性和性能問題。

本文將為您介紹一個強大而專業的 .NET 組件——Spire.XLS for .NET，它能夠幫助您擺脱這些困擾，輕鬆實現 C# 讀取 Excel 的需求。我們將詳細講解如何利用 Spire.XLS for .NET 庫，以清晰、可操作的步驟和代碼示例，讀取 Excel 工作表中的全部內容。

1. Spire.XLS for .NET 快速入門

Spire.XLS for .NET 是一款由 E-iceblue 公司開發的專業 Excel 處理組件，它允許開發者在 .NET 應用程序中創建、讀取、寫入、轉換和打印 Excel 文件，而無需安裝 Microsoft Office。其主要優勢包括：

無需 Office 環境： 獨立運行，不依賴 Office 軟件，簡化部署。
高性能： 針對大數據量處理進行了優化，讀寫速度快。
功能全面： 支持各種 Excel 特性，如單元格樣式、公式、圖表、批註等。
兼容性強： 支持 .NET Core, .NET Standard, .NET 5+ 以及傳統的 .NET Framework。

安裝與引用

使用 Spire.XLS for .NET 非常簡單，您可以通過 NuGet 包管理器將其添加到您的 C# 項目中。

打開 Visual Studio，在您的項目中右鍵點擊“引用”或“依賴項”，選擇“管理 NuGet 包”。
在“瀏覽”選項卡中搜索 Spire.XLS。
選擇 Spire.XLS 包並點擊“安裝”。

您也可以在 NuGet 包管理器控制枱中運行以下命令進行安裝：

Install-Package Spire.XLS

安裝完成後，您就可以在代碼中引用命名空間，開始您的 Excel 操作 C# 之旅了。

2. 讀取整個工作表內容的核心步驟與代碼

現在，讓我們通過一個具體的代碼示例，演示如何使用 Spire.XLS for .NET 讀取 Excel 文件中第一個工作表的所有數據。

步驟分解

加載 Excel 文件： 使用 Workbook 對象加載目標 Excel 文件。
獲取工作表： 通過 Workbook.Worksheets 集合獲取需要讀取的工作表。
遍歷行和列： 迭代工作表中的行和列，訪問每個單元格。
獲取單元格數據： 提取每個單元格的值。

代碼示例

假設我們有一個名為 Sample.xlsx 的 Excel 文件，其中包含一些數據。以下代碼將讀取該文件的第一個工作表，並將所有單元格的內容打印到控制枱。

using System;
using Spire.Xls; // 引入 Spire.Xls 命名空間

namespace ReadExcelDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 創建一個 Workbook 實例並加載 Excel 文件
            // 請確保 'Sample.xlsx' 文件存在於應用程序運行目錄下，或提供完整路徑
            Workbook workbook = new Workbook();
            workbook.LoadFromFile("Sample.xlsx");

            // 2. 獲取第一個工作表（索引從0開始）
            Worksheet sheet = workbook.Worksheets[0];

            Console.WriteLine($"正在讀取工作表: {sheet.Name}");
            Console.WriteLine("-----------------------------------");

            // 3. 遍歷工作表中的所有行和列
            // sheet.LastRow 和 sheet.LastColumn 獲取工作表中包含數據的最後一行和最後一列的索引
            for (int row = 1; row <= sheet.LastRow; row++) // 行索引通常從1開始
            {
                for (int col = 1; col <= sheet.LastColumn; col++) // 列索引通常從1開始
                {
                    // 4. 獲取單元格對象並提取其值
                    // sheet.Range[row, col] 可以獲取指定行和列的單元格
                    CellRange cell = sheet.Range[row, col];
                    
                    // cell.Value 屬性用於獲取單元格的原始值，可以根據需要進行類型轉換
                    // cell.Text 屬性用於獲取單元格的顯示文本（格式化後的字符串）
                    Console.Write($"{cell.Text}\t"); 
                }
                Console.WriteLine(); // 每讀取完一行，換行
            }

            Console.WriteLine("-----------------------------------");
            Console.WriteLine("Excel 內容讀取完畢！");

            // 釋放資源
            workbook.Dispose();
            Console.ReadKey();
        }
    }
}

關鍵方法/屬性解釋：

Workbook: 代表一個 Excel 工作簿文件。
Workbook.LoadFromFile(string filePath): 用於從指定路徑加載 Excel 文件。
Workbook.Worksheets: 一個集合，包含工作簿中的所有 Worksheet 對象。
Worksheet: 代表一個 Excel 工作表。
Worksheet.LastRow: 獲取工作表中包含數據的最後一行的索引。
Worksheet.LastColumn: 獲取工作表中包含數據的最後一列的索引。
Worksheet.Range[int row, int column]: 通過行和列索引獲取 CellRange 對象。
CellRange.Text: 獲取單元格格式化後的顯示文本。
CellRange.Value: 獲取單元格的原始值，可以是字符串、數字、日期等。

通過以上代碼，您已經掌握了 C# 解析 Excel 的基本方法，能夠高效地獲取 Excel 工作表中的所有數據。

3. 常見讀取場景與進階提示

除了遍歷整個工作表，Spire.XLS for .NET 還提供了更靈活的讀取方式：

獲取特定單元格/區域數據：
- 獲取 A1 單元格的值：string value = sheet.Range["A1"].Text;
- 獲取 B2 單元格的數值：double number = sheet.Range["B2"].NumberValue;
- 獲取特定區域的數據：CellRange range = sheet.Range["A1:C5"]; 然後可以遍歷 range 中的單元格。
處理不同數據類型： Spire.XLS for .NET 會嘗試自動識別單元格的數據類型。您可以使用 CellRange.Value 獲取原始值，然後根據需要進行類型轉換，或者使用 CellRange.NumberValue、CellRange.DateTimeValue 等屬性直接獲取特定類型的值。
錯誤處理建議： 在實際應用中，務必添加異常處理機制，例如使用 try-catch 塊來捕獲文件不存在、文件損壞或權限不足等問題，增強程序的健壯性。
性能優化提示： 對於包含數十萬行甚至更多數據的大型 Excel 文件，可以考慮分批次讀取數據，或者利用 Spire.XLS for .NET 提供的更高級的數據導入導出功能，例如直接將數據導入到 DataTable 中，以提高效率。

總結

本文詳細介紹瞭如何利用強大的 Spire.XLS 庫在 C# 應用程序中輕鬆讀取 Excel 內容。從安裝配置到核心代碼示例，我們展示了其簡潔易用的 API 和強大的功能。無論是數據導入、報表處理還是數據分析，Spire.XLS for .NET 都能為您提供高效、穩定的解決方案，幫助您擺脱傳統方式的困擾。