如何在 C# 中導入、讀取和操作 Excel 數據

為什麼StreamReader無法讀取Excel檔案？

StreamReader 專為純文字檔案設計，使用指定的編碼逐行讀取字元資料。 Excel 檔案雖然看起來像電子表格，但實際上是複雜的二進位或 ZIP 壓縮的 XML 結構，StreamReader 無法解釋。 現代的XLSX 檔案遵循 Office Open XML 標準，而較舊的XLS 檔案使用專有的二進位格式。

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

執行此程式碼片段時，您將看到的不是電子表格數據，而是二進位數據，例如"PK♥♦"或類似字元。 這是因為 XLSX 檔案是包含多個 XML 檔案的 ZIP 壓縮文件，而 XLS 檔案使用專有的二進位格式。 StreamReader 期望純文本，並嘗試將這些複雜的結構解釋為字符，從而導致無意義的輸出。 對於容器化應用程序，嘗試使用原生 Excel 庫或 COM 互通將需要在容器中安裝 Microsoft Office，這將大大增加鏡像大小和複雜性。

如何使用IronXL讀取 Excel 檔案？

IronXL為使用 C# 讀取 Excel 檔案提供了一個簡單的解決方案。 與 StreamReader 不同， IronXL了解 Excel 的內部結構，並提供直覺的方法來存取您的資料。 該程式庫支援Windows、Linux、macOS和Docker 容器，使其成為現代跨平台應用程式的理想選擇。 對於 DevOps 團隊來說，IronXL 的零依賴架構意味著在部署期間無需管理任何本機程式庫或 COM 元件。

首先，透過NuGet套件管理器安裝IronXL ：

Install-Package IronXL.Excel

以下是正確讀取Excel檔案的方法：

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

這段程式碼可以成功載入您的 Excel 文件，並提供對儲存格值的清晰存取。 WorkBook.Load 方法會自動偵測檔案格式( XLSX 、 XLS 、XLSM、 CSV )，並在內部處理所有複雜的解析。 您可以使用熟悉的 Excel 表示法(例如"A1")或範圍(例如"A1:C5")來存取儲存格，這使得任何熟悉 Excel 的人都能直觀地理解程式碼。

對於容器化部署，您可以輕鬆新增執行狀況檢查端點，以驗證 Excel 處理能力：

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

如何從記憶體流中讀取Excel？

實際應用中經常需要處理來自資料流而不是磁碟檔案的 Excel 檔案。 常見情境包括處理網路上傳、從資料庫擷取檔案或處理來自雲端儲存(如AWS S3或Azure Blob Storage)的資料。 IronXL可以輕鬆應對這些情況：

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

FromStream 方法接受任何流類型，無論是 FileStream 或網路流。 這種靈活性使您無需先將 Excel 檔案儲存到磁碟即可處理來自各種來源的檔案。此範例還示範如何將工作表資料轉換為 DataTable ，DataTable 可以與資料庫和資料綁定場景無縫整合。 對於微服務架構而言，這種基於流的方法可以最大限度地減少磁碟 I/O 並提高效能。

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

如何在Excel和CSV之間進行轉換？

雖然 StreamReader 可以處理 CSV 文件，但您經常需要在 Excel 和 CSV 格式之間進行轉換。 IronXL讓這種轉換變得非常簡單，這對於 ETL 管道和資料整合場景尤其有用，這些場景在 DevOps 工作流程中很常見：

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

這些轉換操作會在變更檔案格式的同時保留您的資料。 將 Excel 檔案轉換為 CSV 檔案時， IronXL預設會將第一個工作表展平，但您可以指定要匯出的工作表。 將CSV 檔案轉換為 Excel 檔案會建立一個格式正確的電子表格，該電子表格可以保留資料類型，並允許將來進行格式設定和新增公式。

對於自動化資料管道，您也可以匯出為 JSON或XML 格式：

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

容器部署最佳實踐

對於部署 Excel 處理應用程式的工程師來說， IronXL提供了幾個優勢。 以下是一個針對 Excel 處理最佳化的生產就緒型 Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# Install any required system fonts for Excel rendering
RUN apt-get update && apt-get install -y \
    fontconfig \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet build -c Release -o /app/build

FROM build AS publish
RUN dotnet publish -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set environment variables for IronXL
ENV IRONXL_LICENSE_KEY=${IRONXL_LICENSE_KEY}
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

ENTRYPOINT ["dotnet", "YourApp.dll"]

此 Dockerfile 可確保您的 Excel 處理應用程式在容器中流暢地執行，並最大限度地減少依賴項。 許可證透過環境變數進行管理，因此可以輕鬆地在不同的部署環境中進行管理。

C#中Excel處理的下一步是什麼？

StreamReader 無法處理 Excel 檔案的原因在於純文字與 Excel 複雜的檔案結構之間存在根本差異。 雖然 StreamReader 可以完美地處理 CSV 和其他文字格式，但真正的 Excel 檔案需要像IronXL這樣的專門庫來理解其中的二進位和 XML 結構。

IronXL提供全面的解決方案，其直覺的 API、廣泛的格式支援和無縫的串流處理功能。 無論您是建立Web 應用程式、桌面軟體或雲端服務， IronXL都能在所有平台上可靠地處理 Excel 檔案。 該程式庫支援條件格式、 圖表、公式和進階 Excel 功能，使其成為企業應用程式的完整解決方案。

對於 DevOps 團隊而言，IronXL 的容器友善架構、最小的系統依賴性和可靠的效能特點使其成為現代雲端原生應用程式的理想選擇。 該庫支援水平擴展，可在Kubernetes pod中無縫運行，並能很好地與 CI/CD 管道整合。

準備好開始正確使用Excel檔案了嗎？ 下載最符合您專案需求的 IronXL 免費試用版。 該程式庫提供靈活的授權選項，包括開發、測試和生產部署，以及容器化環境和雲端原生應用程式的選項。