跳過到頁腳內容
使用 IRONXL

為何 `ExcelDataReader` 無法寫入 Excel 檔案以及 IronXL 如何解決此問題

ExcelDataReader只能讀取 Excel 文件,不能寫入 Excel 文件。 IronXL 提供全面的解決方案,可無縫處理讀取和寫入操作,實現包括寫入功能在內的完整 Excel 操作。

許多開發人員在尋找用於在 C# 中處理 Excel 檔案的輕量級解決方案時發現了ExcelDataReader 。 然而,他們很快就遇到了一個根本性的限制:儘管它的名稱暗示了完整的 Excel 功能,但ExcelDataReader無法寫入 Excel 檔案。 本文澄清了這個常見的誤解,並將IronXL介紹為一個全面的替代方案,它可以無縫地處理Excel 文件的讀取和寫入。 本指南的重點是幫助您以簡潔的方式處理 Excel 的編寫要求。

在本指南中,您將了解為什麼ExcelDataReader無法寫入 Excel 文件,IronXL 如何解決此限制,以及如何透過可運行的程式碼範例開始使用。 此外,您還將學習如何轉換 CSV 資料、使用陣列物件填充列以及使用各種編碼選項在不同的檔案格式之間傳遞資料。 無論您是建立ASP.NET 應用程式還是使用.NET MAUI ,了解這些限制對於選擇合適的程式庫至關重要。

ExcelDataReader能否寫入 Excel 工作簿資料?

! ExcelDataReader GitHub 倉庫截圖,顯示專案描述、建置狀態和支援的 Excel 檔案格式表格,突出顯示其唯讀特性

不, ExcelDataReader不能寫入 Excel 檔案。 該庫專為讀取各種格式(XLS、XLSX、CSV)的 Excel 文件而設計。 雖然它是用於在 C# 中快速讀取 Excel 檔案的庫,但它的功能僅限於此。 官方 GitHub 倉庫明確指出,這是一個"用於讀取 Microsoft Excel 文件的庫",不具備寫入功能。 安裝軟體包並在專案中引用 DLL 後,您會發現它無法處理寫入編碼、跳過行以修復資料問題,也無法在通用集合中使用列名和整數值。

以下是ExcelDataReader功能,它需要一個新的ExcelReaderConfiguration實例來處理伺服器部署的檔案路徑和記憶體設定:

using ExcelDataReader;
using System.IO;
// ExcelDataReader can ONLY read files
using (var stream = File.Open("data.xlsx", FileMode.Open, FileAccess.Read))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        // Read data from Excel
        while (reader.Read())
        {
            var value = reader.GetString(0); // Read cell value
        }
        // But there's no way to write back to the file
    }
}
using ExcelDataReader;
using System.IO;
// ExcelDataReader can ONLY read files
using (var stream = File.Open("data.xlsx", FileMode.Open, FileAccess.Read))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        // Read data from Excel
        while (reader.Read())
        {
            var value = reader.GetString(0); // Read cell value
        }
        // But there's no way to write back to the file
    }
}
Imports ExcelDataReader
Imports System.IO

' ExcelDataReader can ONLY read files
Using stream = File.Open("data.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        ' Read data from Excel
        While reader.Read()
            Dim value = reader.GetString(0) ' Read cell value
        End While
        ' But there's no way to write back to the file
    End Using
End Using
$vbLabelText   $csharpLabel

這段程式碼示範了ExcelDataReader的唯讀特性。 該函式庫可以有效率地從 Excel 檔案中提取數據,但沒有提供 Write()、Save() 或SetCellValue () 等方法。 需要建立報表更新電子表格、產生新的 Excel 檔案、記錄資訊、將結果發佈到其他系統、對儲存格進行註解、實作 LINQ 查詢或填入標籤和元資料的開發人員必須另尋他處。 當您需要將資料匯出到 Excel以程式設計方式建立 Excel 圖表時,這種限制就顯得尤為明顯。

IronXL 如何解決寫作難題?

IronXL for .NET 主頁展示了無需 Microsoft Office 即可讀寫 Excel 文件的 C# 程式碼範例,並提供下載選項和全面的功能。

IronXL 提供完整的 Excel 操作功能,可讓開發人員讀取、建立、編輯和儲存 Excel 文件,而無需依賴 Microsoft Office。 與唯讀解決方案不同,IronXL 將 Excel 檔案視為完全可編輯的文件。 這種簡單直接的方法讓您可以處理CSV 資料轉換、在不同格式之間轉換,並無縫填入表格。 該程式庫支援多種平台,包括WindowsmacOS ,甚至Docker 容器

我該如何開始使用 IronXL?

安裝 IronXL 只需要一條 NuGet 指令:

Install-Package IronXL.Excel

基本實作遵循常見的模式:

using IronXL;
// Your first IronXL application
class Program
{
    static void Main()
    {
        // Create workbook
        WorkBook workBook = WorkBook.Create();
        WorkSheet sheet = workBook.CreateWorkSheet("Data");    
        // Write your data
        sheet["A1"].Value = "Hello Excel";
        // Save to file
        workBook.SaveAs("output.xlsx");
    }
}
using IronXL;
// Your first IronXL application
class Program
{
    static void Main()
    {
        // Create workbook
        WorkBook workBook = WorkBook.Create();
        WorkSheet sheet = workBook.CreateWorkSheet("Data");    
        // Write your data
        sheet["A1"].Value = "Hello Excel";
        // Save to file
        workBook.SaveAs("output.xlsx");
    }
}
Imports IronXL

' Your first IronXL application
Class Program
    Shared Sub Main()
        ' Create workbook
        Dim workBook As WorkBook = WorkBook.Create()
        Dim sheet As WorkSheet = workBook.CreateWorkSheet("Data")
        ' Write your data
        sheet("A1").Value = "Hello Excel"
        ' Save to file
        workBook.SaveAs("output.xlsx")
    End Sub
End Class
$vbLabelText   $csharpLabel

在這裡,我們輕鬆地建立了一個新的 Excel 工作簿和一個名為"資料"的新 Excel 工作表。 在這個新工作表中,您可以輕鬆地新增來自CSV 檔案資料表資料集和其他資料來源的資料。 .NET Core 平台支援分隔符號分隔的檔案和各種編碼格式。 IronXL 也能無縫處理Excel 元資料工作表管理

對於從ExcelDataReader遷移的開發人員來說,過渡過程涉及將唯讀操作替換為 IronXL 的讀寫方法。 IronXL 的學習曲線非常平緩,因為它使用了與 Excel 儲存格引用系統類似的直覺式語法。 您可以輕鬆地選擇儲存格區域套用格式,甚至可以為儲存格新增超連結

開始免費試用,探索 IronXL 的完整功能集,或查看全面的文件以獲取詳細範例和API 參考

如何執行基本寫入操作?

使用 IronXL建立和寫入 Excel 檔案非常簡單:

using IronXL;
// Create a new Excel file
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Report");
// Write values to specific cells
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 100;
// Save the file
workBook.SaveAs("inventory.xlsx");
using IronXL;
// Create a new Excel file
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Report");
// Write values to specific cells
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 100;
// Save the file
workBook.SaveAs("inventory.xlsx");
Imports IronXL

' Create a new Excel file
Dim workBook As WorkBook = WorkBook.Create()
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write values to specific cells
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("A2").Value = "Widget"
sheet("B2").Value = 100

' Save the file
workBook.SaveAs("inventory.xlsx")
$vbLabelText   $csharpLabel

此範例建立一個新的工作簿,為指定儲存格新增數據,並儲存結果。 直覺的單元格尋址(sheet["A1"])使程式碼易於閱讀和維護。 您也可以寫入 CSV 檔案匯入現有的 Excel 檔案進行修改。

Excel電子表格,展示了一個簡單的產品庫存表,帶有格式化的表頭和範例資料條目,演示了基本的寫作能力。

有哪些高階寫作功能?

IronXL 的功能不僅限於基本的儲存格寫入,還支援複雜的 Excel 操作:

// Write formulas
sheet["C1"].Value = "Total";
sheet["C2"].Formula = "=B2*1.5";
// Write ranges efficiently
sheet["A3:A10"].Value = "Item";
// Apply formatting while writing
sheet["B2"].Style.Font.Bold = true;
sheet["B2"].Style.BackgroundColor = "#FFFF00";
// Add borders and alignment
sheet["A1:C1"].Style.Border.TopBorder = IronXL.Styles.BorderType.Thick;
sheet["A1:C1"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;
// Write formulas
sheet["C1"].Value = "Total";
sheet["C2"].Formula = "=B2*1.5";
// Write ranges efficiently
sheet["A3:A10"].Value = "Item";
// Apply formatting while writing
sheet["B2"].Style.Font.Bold = true;
sheet["B2"].Style.BackgroundColor = "#FFFF00";
// Add borders and alignment
sheet["A1:C1"].Style.Border.TopBorder = IronXL.Styles.BorderType.Thick;
sheet["A1:C1"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;
' Write formulas
sheet("C1").Value = "Total"
sheet("C2").Formula = "=B2*1.5"
' Write ranges efficiently
sheet("A3:A10").Value = "Item"
' Apply formatting while writing
sheet("B2").Style.Font.Bold = True
sheet("B2").Style.BackgroundColor = "#FFFF00"
' Add borders and alignment
sheet("A1:C1").Style.Border.TopBorder = IronXL.Styles.BorderType.Thick
sheet("A1:C1").Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center
$vbLabelText   $csharpLabel

這些功能使開發人員能夠以程式設計方式產生專業的 Excel 報告,包括計算和格式設定。 IronXL 支援編輯公式套用儲存格樣式設定資料格式。 對於條件格式設定Excel 圖表等更進階的功能,IronXL 提供了全面的文件。 您甚至可以合併儲存格凍結窗格,以便更好地呈現資料。

Excel電子表格,顯示產品及其數量,使用公式計算總計,應用格式(包括邊框和顏色),示範進階編寫功能。

其他進階功能包括自動調整行和列的大小背景圖案和顏色以及邊框對齊方式。 IronXL 還支援命名區域命名表,以便建立更有條理的電子表格結構。

實現方式有何不同?

比較典型的工作流程時,根本差異就顯而易見了。 考慮一個常見的需求:從一個 Excel 檔案讀取資料並建立一個修改過的版本。 在使用 VB.NET Excel 檔案或需要在電子表格檔案類型之間進行轉換時,這種情況很常見。

為什麼ExcelDataReader的方法存在不足?

// Read with ExcelDataReader
List<string> data = new List<string>();
using (var stream = File.Open("source.xlsx", FileMode.Open))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        while (reader.Read())
        {
            data.Add(reader.GetString(0));
        }
    }
}
// Cannot write back to Excel - need another library!
// Read with ExcelDataReader
List<string> data = new List<string>();
using (var stream = File.Open("source.xlsx", FileMode.Open))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        while (reader.Read())
        {
            data.Add(reader.GetString(0));
        }
    }
}
// Cannot write back to Excel - need another library!
Imports System.IO
Imports ExcelDataReader

Dim data As New List(Of String)()
Using stream = File.Open("source.xlsx", FileMode.Open)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            data.Add(reader.GetString(0))
        End While
    End Using
End Using
' Cannot write back to Excel - need another library!
$vbLabelText   $csharpLabel

當需要清除儲存格複製儲存格或執行任何修改操作時,此限制會成為問題。 ExcelDataReader的架構根本不支援輸出操作。

IronXL 如何提供完整的解決方案?

// Read and write with IronXL
WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;
// Read existing data
string originalValue = sheet["A1"].StringValue;
// Modify and add new data
sheet["A1"].Value = originalValue.ToUpper();
sheet["B1"].Value = DateTime.Now;
// Add rows and columns dynamically
sheet.InsertRow(2); // Insert a new row at position 2
sheet.InsertColumn(3); // Insert a new column at position C
// Save as new file
workBook.SaveAs("modified.xlsx");
// Read and write with IronXL
WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;
// Read existing data
string originalValue = sheet["A1"].StringValue;
// Modify and add new data
sheet["A1"].Value = originalValue.ToUpper();
sheet["B1"].Value = DateTime.Now;
// Add rows and columns dynamically
sheet.InsertRow(2); // Insert a new row at position 2
sheet.InsertColumn(3); // Insert a new column at position C
// Save as new file
workBook.SaveAs("modified.xlsx");
' Read and write with IronXL
Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet
' Read existing data
Dim originalValue As String = sheet("A1").StringValue
' Modify and add new data
sheet("A1").Value = originalValue.ToUpper()
sheet("B1").Value = DateTime.Now
' Add rows and columns dynamically
sheet.InsertRow(2) ' Insert a new row at position 2
sheet.InsertColumn(3) ' Insert a new column at position C
' Save as new file
workBook.SaveAs("modified.xlsx")
$vbLabelText   $csharpLabel

IronXL 為所有 Excel 操作提供統一的 API。 這樣就無需混合使用多個庫,從而降低了複雜性並減少了潛在的兼容性問題。 您可以透過簡單的方法呼叫來新增行和列對儲存格區域進行排序,甚至對行和列進行分組和取消分組

何時該使用 IronXL?

當您的應用程式需要以下功能時,IronXL 將變得必不可少:

*報表產生:*根據資料庫查詢或 API 回應建立 Excel 報表 資料匯出:將應用程式和 CSV 資料轉換為 Excel 格式供使用者使用 模板處理:使用動態資料填入 Excel 模板 電子表格自動化:**使用新資訊更新現有文件 *批次處理:以程式設計方式修改多個 Excel 文件

僅使用ExcelDataReader無法實現這些功能。 雖然ExcelDataReader擅長從現有文件中提取數據,但任何產生或修改 Excel 文件的需求都需要一個具有寫入功能的庫。 當您需要實作轉換資料、從陣列物件填入列名、修復格式問題、記錄變更或將結果發佈到伺服器的解決方案時,IronXL 提供了一套完整的工具集。 該庫甚至支援Blazor 應用程序,並且無需 Excel Interop即可運行。

IronXL 的全面功能尤其有利於商業應用。 無論是產生發票、建立庫存報告或產生財務報表,讀取來源資料和寫入格式化輸出的能力都能簡化開發流程。 IronXL 的授權模式為不同的部署場景提供了靈活性,並且該程式庫保持了高安全標準

下一步是什麼?

ExcelDataReader有特定的用途:有效率地讀取 Excel 檔案。 然而,現代應用程式通常需要與 Excel 進行雙向互動。 IronXL 透過在單一、統一的庫中提供完整的 Excel 操作功能來滿足這一需求。 開發人員無需組合使用多個工具或克服各種限制,即可使用統一的 API 處理所有 Excel 操作。 該庫透過定期更新效能改進來保持最新狀態。

準備好擺脫Excel只讀操作了嗎? 首先使用IronXL 的免費試用版,體驗在 .NET 應用程式中對 Excel 的全面控制。 對於生產環境應用,請考慮包含專屬支援和靈活部署方式的授權選項。 需要入門協助嗎? 請查看許可證密鑰申請指南故障排除資源,以便順利實施。

常見問題解答

為什麼 ExcelDataReader 無法寫入 Excel 檔案?

ExcelDataReader 主要用於讀取 Excel 檔案。儘管它的名字叫 ExcelDataReader,但它缺乏寫入 Excel 檔案的能力,這對需要完整 Excel 功能的開發人員而言是一種限制。

在撰寫 Excel 檔案時,ExcelDataReader 的全面替代方案是什麼?

IronXL 是一個全面的替代方案,可同時以 C# 語言讀取和寫入 Excel 檔案。它提供了處理 Excel 文件的無縫體驗。

IronXL.Excel 如何在 C# 中加強 Excel 檔案處理?

IronXL.Excel 提供強大的功能,可從 Excel 檔案讀取或寫入 Excel 檔案,增強 Excel 檔案處理能力,而 ExcelDataReader 則無法做到這一點。

IronXL 能有效率地處理大型 Excel 檔案嗎?

是的,IronXL.Excel 已針對效能進行最佳化,可有效處理大型 Excel 檔案,因此適合需要處理大量資料集的應用程式。

IronXL 是否容易整合到現有的 C# 專案中?

IronXL 的設計可輕鬆整合至 C# 專案中,提供廣泛的 API 說明文件和範例,讓實作過程更順暢。

與 ExcelDataReader 相比,使用 IronXL 有哪些好處?

與 ExcelDataReader 相比,使用 IronXL 的主要優點是除了讀取 Excel 檔案外,還能寫入 Excel 檔案,提供完整的 Excel 檔案操作功能。

IronXL.Excel 支援公式和圖表等進階 Excel 功能嗎?

是的,IronXL.Excel 支援進階 Excel 功能,例如公式、圖表和其他複雜功能,可全面管理 Excel 檔案。

IronXL 可以同時用於 .NET Framework 和 .NET Core 專案嗎?

IronXL 與 .NET Framework 和 .NET Core 相容,為跨不同 C# 專案類型工作的開發人員提供彈性。

使用 IronXL 有學習曲線嗎?

IronXL 使用方便,提供詳盡的說明文件和範例,將學習曲線降至最低,使開發人員能快速發揮其全部潛力。

IronXL 用戶可獲得哪些支援資源?

IronXL 提供廣泛的支援資源,包括文件、教學,以及回應迅速的支援團隊,協助使用者解決任何疑問或問題。

Curtis Chau
技術撰稿人

Curtis Chau 擁有電腦科學學士學位(卡爾頓大學),專長於前端開發,精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情,他喜歡使用現代化的架構,並製作結構良好且視覺上吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 也有濃厚的興趣,他喜歡探索整合硬體與軟體的創新方式。在空閒時間,他喜歡玩遊戲和建立 Discord bots,將他對技術的熱愛與創意結合。