在現代企業應用中，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 都能為您提供高效、穩定的解決方案，幫助您擺脱傳統方式的困擾。
