如何在未安裝Excel的情況下在C#中讀取開放式Office Excel文件

如何在.NET專案中安裝IronXL ？

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

如何在 C# 中載入 OpenOffice 或 Excel 檔案？

IronXL透過 WorkBook.Load 方法以相同的方式處理 光學資料系統、XLS、XLSX 和 CSV 檔案。 你可以傳遞絕對或相對檔案路徑，函式庫會從檔案頭(而不僅僅是副檔名)偵測檔案格式。 這意味著將檔案從 .ods 重新命名為 .xlsx 仍然可以正確讀取。

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

同樣的呼叫方法也適用於 XLSX 和 XLS 檔案——只需更改路徑即可。 WorkBook.Load 無論來源格式如何，都會返回相同的強類型對象，因此無論文件來自 Microsoft Excel、LibreOffice 還是任何其他符合 ODF 標準的應用程序，其餘代碼都保持不變。

如何讀取工作表中的每一行和每一儲存格？

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

如何從儲存格中提取已輸入的值？

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

如何處理多個已命名的工作表？

using IronXL;

WorkBook workbook = WorkBook.Load("annual_sales.xlsx");

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

WorkBook workbook = WorkBook.Load("annual_sales.xlsx");

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

如何處理合併儲存格和格式化區域？

報表和儀表板經常使用合併儲存格作為標題、分組標籤和總計行。 IronXL會讀取合併區域左上角儲存格的值，與 Excel 顯示的值完全相同：

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Style 屬性樹反映了OOXML SpreadsheetML 規範的結構，因此如果您使用過 Open XML SDK，屬性名稱會感覺很熟悉。 然而， IronXL將所有這些複雜性封裝在一個簡潔的 API 中，而無需您進行任何 XML 操作。

如何使用同一個API匯入CSV檔案？

資料庫匯出、CRM 系統和舊版應用程式產生的 CSV 檔案可以透過相同的 WorkBook.Load 呼叫讀取。 IronXL從檔案內容推斷分隔符號：

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

載入完成後，您可以使用 csvWorkbook.SaveAs("output.xlsx") 將資料儲存為 XLSX。 這是 CSV 到 Excel 轉換管道的常見模式——接收 CSV 文件，用計算列或格式豐富它，並將格式化的 XLSX 報告返回給用戶。

對於製表符分隔的檔案或自訂分隔符，請使用 WorkBook.LoadCSV("file.tsv", file格式: ExcelFile格式.TSV) 明確指定格式。

IronXL與 Microsoft.Office.Interop.Excel 相比如何？

如何在 Linux 和 Docker 上部署 Excel Processing？

在伺服器部署中，IronXL 獨立於 Excel 的優勢體現得最為明顯。 在 Windows 上編寫的相同程式碼，在 Ubuntu、Alpine Linux 或 macOS 上無需修改即可運行。 對於容器化部署，您的 Dockerfile 不需要任何特殊配置：

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

對於Azure Functions和 AWS Lambda， IronXL可在託管運行時中運行，無需任何額外配置。 由於沒有 COM 初始化步驟，冷啟動開銷極小。

線程安全是內建的：多個線程可以同時打開不同的 WorkBook 實例而無需協調。 如果您需要並行處理數千個檔案(例如，在背景作業中處理使用者上傳的電子表格)，則可以在 Parallel.ForEach 或 Task.WhenAll 實例池中使用 WorkBook 實例，而不會有損壞的風險。

由於IronXL在初始化時只將請求的工作表載入到記憶體中，而不是將整個工作簿載入到記憶體中，因此記憶體使用情況保持可預測性。 對於非常大的文件，這種差異很重要：一個包含十個 50MB 工作表的簿子並不需要 500MB 的 RAM 來讀取單一工作表。 IronXL效能文件涵蓋了處理大容量文件處理場景的其他策略。

下一步計劃是什麼？

在專案中驗證IronXL 的最快方法是安裝NuGet包，然後針對環境中的真實檔案執行本指南中的範例。 免費試用許可證可解鎖所有功能，無需更改代碼即可在準備投入生產時使用。

探索IronXL 的其他相關功能，這些功能可以補充檔案讀取功能：

使用 C# 編寫和建立 Excel 檔案－以程式設計方式建立報表和資料匯出 -設定儲存格、行和列的格式－透過程式碼套用顏色、字型和邊框。 -使用 C# 處理 Excel 公式－讀取和寫入公式儲存格 -在.NET中將 Excel 轉換為 PDF -- 從電子表格資料產生 PDF 報告 IronXL API 文件－所有類別和方法的完整參考 IronXL 的授權和定價——個人開發者和企業團隊的選項 IronXL NuGet頁面-- 所有項目類型的安裝說明

• IronXL教學－常見用例的逐步指南
• IronXL與 EPPlus 的對比——功能和許可對比 IronXL產品主頁－功能概述與入門資源

對於許可、跨平台支援或特定文件格式要求方面的問題， IronXL支援團隊可透過線上聊天和電子郵件提供協助。

立即開始在您的項目中使用 IronXL 並免費試用。

第一步：

免費啟動