ExcelDataReader zapisuje pliki Excel: Dlaczego nie może i jak IronXL to rozwiązuje

Czy ExcelDataReader może zapisywać dane z skoroszytów Excel?

Nie. ExcelDataReader jest z założenia biblioteką tylko do odczytu, a to ograniczenie jest zamierzone. Oficjalne repozytorium ExcelDataReader na GitHubie opisuje projekt wyraźnie jako "bibliotekę do odczytu plików Microsoft Excel" — w publicznej części nie ma API do zapisu, metody zapisywania ani ustawiania wartości komórek. Można to sprawdzić samodzielnie, przeglądając stronę pakietu ExcelDataReader NuGet, gdzie opis pakietu podkreśla jego zakres tylko do odczytu.

ExcelDataReader obsługuje formaty XLS, XLSX i CSV do odczytu i wykonuje to zadanie skutecznie. Biblioteka udostępnia wzorzec czytnika strumieniowego, działającego wyłącznie w kierunku do przodu, podobny do IDataReader w ADO.NET. Architektura ta doskonale nadaje się do szybkiego pozyskiwania dużych zbiorów danych, ale jest zasadniczo niezgodna z modelem zmiennym o swobodnym dostępie, którego wymaga zapis w programie Excel.

Poniższy kod ilustruje ograniczenia, na które natrafisz przy użyciu ExcelDataReader:

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

Imports ExcelDataReader
Imports System.Text
Imports System.IO

' Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

Using stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            Dim cellValue As String = reader.GetString(0) ' Read a cell value
            Console.WriteLine(cellValue)
            ' There is no Write(), Save(), or SetCellValue() method here
        End While
    End Using
End Using

Po wywołaniu Read() po prostu nie ma odpowiednika Write() ani Save(). Gdy Twoja aplikacja musi generować raporty, aktualizować komórki arkusza kalkulacyjnego, eksportować dane do formatu XLSX, stosować formuły lub przetwarzać szablony, ExcelDataReader zapewnia Ci kompletny zestaw narzędzi.

To nie jest błąd. Jest to świadoma decyzja dotycząca zakresu. ExcelDataReader dobrze wykonuje jedną rzecz i na tym kończy. Każdy proces, który wymaga zapisywania danych z powrotem do Excela, wymaga zupełnie innej biblioteki.

W jaki sposób IronXL rozwiązuje problem pisania?

IronXL zapewnia ujednolicony interfejs API do odczytu, tworzenia, modyfikowania i zapisywania plików Excel bez konieczności instalacji pakietu Microsoft Office. Biblioteka traktuje skoroszyt programu Excel jako w pełni zmienny, przechowywany w pamięci graf obiektów. Wczytujesz lub tworzysz skoroszyt, przechodzisz do dowolnej komórki za pomocą odwołania, ustawiasz wartości lub formuły, stosujesz style, a następnie wywołujesz SaveAs() — jest to przebieg pracy odzwierciedlający sposób, w jaki człowiek pracowałby w samym programie Excel.

IronXL obsługuje formaty XLSX, XLS, CSV, TSV i JSON zarówno dla danych wejściowych, jak i wyjściowych. Działa na platformach .NET 10, .NET Standard i .NET Framework, dzięki czemu nadaje się zarówno do aplikacji konsolowych, interfejsów API sieci Web ASP.NET Core, narzędzi desktopowych, jak i usług przetwarzania w tle.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write header row
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("C1").Value = "Unit Price"

' Write a data row
sheet("A2").Value = "Widget"
sheet("B2").Value = 150
sheet("C2").Value = 9.99

workBook.SaveAs("report.xlsx")
Console.WriteLine("Workbook saved.")

Jak czytać i pisać w jednym przepływie pracy IronXL?

Częstym wymaganiem jest odczytanie istniejącego pliku Excel, przekształcenie jego danych i zapisanie wyników z powrotem. ExcelDataReader obsługuje tylko pierwszy krok, co oznacza, że trzeba wprowadzić drugą bibliotekę — to niepotrzebne komplikacje, które zwiększają obciążenie związane z zarządzaniem zależnościami i potencjalnymi konfliktami wersji.

IronXL obejmuje cały proces. Poniższy przykład ładuje plik źródłowy, odczytuje wartości z kolumny A, przekształca je i zapisuje zmodyfikowany skoroszyt jako nowy plik:

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Niew.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Niew.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

Imports 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
Console.WriteLine($"Original: {originalValue}")

' Modify existing data
sheet("A1").Value = originalValue.ToUpper()

' Add new data alongside existing content
sheet("B1").Value = DateTime.Now.ToString("yyyy-MM-dd")
sheet("C1").Formula = "=LEN(A1)"

workBook.SaveAs("modified.xlsx")
Console.WriteLine("Modified workbook saved.")

Wywołanie WorkBook.Load() wczytuje plik do pamięci jako obiekt zmienny. Następnie można poruszać się po komórkach za pomocą odwołań w stylu Excela, aktualizować wartości, ustawiać formuły i zapisywać — wszystko w ramach jednej biblioteki i jednego wzorca API.

Jakie zaawansowane funkcje pisania obsługuje IronXL?

Oprócz prostego przypisywania komórek, IronXL udostępnia pełen zakres funkcji programu Excel, które są zazwyczaj wymagańe w aplikacjach biznesowych.

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

Imports IronXL
Imports IronXl.Styles

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Analytics")

' Write labels
sheet("A1").Value = "Revenue"
sheet("B1").Value = "Cost"
sheet("C1").Value = "Margin"

' Write data
sheet("A2").Value = 50000
sheet("B2").Value = 32000

' Write a calculated formula
sheet("C2").Formula = "=A2-B2"

' Apply bold formatting to the header row
sheet("A1:C1").Style.Font.Bold = True

' Highlight the margin cell
sheet("C2").Style.BackgroundColor = "#D4EDDA"
sheet("C2").Style.Font.Bold = True

workBook.SaveAs("analytics.xlsx")

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

Imports IronXL

' Load a CSV file as if it were a workbook
Dim csvWorkBook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkBook.DefaultWorkSheet

' Apply a bold header style to the first row
csvSheet("A1:Z1").Style.Font.Bold = True

' Save as XLSX
csvWorkBook.SaveAs("converted.xlsx")
Console.WriteLine("CSV converted to XLSX.")

Jak wygląda bezpośrední srovnání ExcelDataReader a IronXL?

Poniższa tabela podsumowuje różnice w możliwościach obu bibliotek w najczęstszych scenariuszach tworzenia aplikacji w Excelu:

ExcelDataReader pozostaje dobrym wyborem, gdy jedynym wymaganiem jest odczyt danych, a rozmiar pliku binarnego ma znaczenie. W każdym scenariuszu wymagającym generowania danych wyjściowych odpowiednim narzędziem jest IronXL.

Kiedy warto korzystać z IronXL?

IronXL to właściwy wybór, gdy Twoja aplikacja musi tworzyć lub modyfikować pliki Excel. Poniższe scenariusze są reprezentatywne dla rzeczywistych wymagań biznesowych, których ExcelDataReader nie jest w stanie spełnić:

• Generowanie raportów: Tworzenie raportów w formacie Excel na podstawie zapytań do bazy danych, odpowiedzi API lub obliczeń w pamięci. Zobacz przewodnik po tworzeniu raportów w Excelu, aby uzyskać szczegółowe instrukcje.
• Eksport danych: Konwersja danych aplikacji — kolekcji, tabel danych (DataTables) lub zestawów danych (DataSets) — do formatu XLSX w celu pobrania lub archiwizacji. Samouczek dotyczący konwersji tabeli danych do formatu Excel przedstawia dokładny interfejs API.
• Przetwarzanie szablonów: załaduj szablon XLSX z komórkami zastępczymi, wypełnij je dynamicznie, a następnie zapisz wypełniony wynik.
• Zmiana plików w trybie wsadowym: Przeglądaj katalog skoroszytów, wprowadzaj zmiany programowo i zapisuj każdy plik. IronXL obsługuje wiele otwartych skoroszytów niezależnie.
• Generowanie faktur i dokumentów finansowych: Twórz dokumenty o strukturze zawierające formuły, formatowanie liczb, scalone komórki i stylizowane nagłówki.
• Konwersja CSV do XLSX: akceptuje pliki przesłane w formacie rozdzielonym przecinkami, przekształca je w ustrukturyzowane skoroszyty i udostępnia użytkownikom pliki XLSX do pobrania.

Aplikacje biznesowe, które wcześniej wymagały biblioteki do odczytu oraz biblioteki do zapisu — lub zależności od automatyzacji programu Excel za pośrednictwem COM — mogą zostać skonsolidowane wyłącznie w IronXL.

W przypadku zaawansowanych scenariuszy wyjściowych dokumentacja dotycząca formatowania warunkówego oraz przewodnik po tworzeniu wykresów obejmują pełen zakres możliwości formatowania i wizualizacji. Strona licencyjna przedstawia opcje wdrożenia produkcyjnego, a pełna Dokumentacja API opisuje każdą klasę i metodę.

Jak rozpocząć korzystanie z bezpłatnej wersji próbnej?

IronXL jest dostępny na bezpłatnej licencji deweloperskiej. Zainstaluj pakiet NuGet, uruchom powyższe przykłady na własnych plikach i sprawdź, czy wynik spełnia Twoje wymagania, zanim zdecydujesz się na zakup licencji produkcyjnej.

Przewodnik IronXL dla początkujących zawiera instrukcje dotyczące instalacji, wzorców pierwszego użycia oraz typowych scenariuszy wraz z kodem, który można uruchomić. Sekcja samouczków szczegółowo omawia przepływy pracy związane z odczytem, co jest przydatne, jeśli aplikacja wymaga zarówno operacji odczytu, jak i zapisu.

Rozpocznij bezpłatny okres próbny, aby uzyskać dostęp do pełnego zestawu funkcji, w tym formatów eksportu, zaawansowanego formatowania, obliczania formuł oraz zarządzania skoroszytami zawierającymi wiele arkuszy. Dla zespołów oceniających bibliotekę na dużą skalę pakiet IronSuite zawiera IronXL wraz z IronPDF, IronOCR i innymi bibliotekami zwiększającymi produktywność w obniżonej cenie łącznej.

Czy nadal warto korzystać z ExcelDataReader?

ExcelDataReader to dobrze utrzymana biblioteka open source o jasnym przeznaczeniu. Jeśli Twoja aplikacja tylko odczytuje pliki Excel i nigdy ich nie zapisuje — na przykład w przypadku potoku pozyskiwania danych, który importuje przesłane pliki XLSX do bazy danych — ExcelDataReader jest rozsądnym i lekkim wyborem. Jego model strumieniowania jest wydajny pod względem pamięci w przypadku bardzo dużych plików.

Problem pojawia się, gdy wymagania się rozszerzają. Aplikacje, które zaczynają jako importatory tylko do odczytu, często ewoluują w kierunku generowania eksportów potwierdzeń, raportów o błędach lub zmodyfikowanych kopii oryginalnych plików. W tym momencie ograniczenia zakresu działania ExcelDataReader stają się przeszkodą, a migracja do biblioteki z obsługą odczytu i zapisu w trakcie projektu jest bardziej uciążliwa niż rozpoczęcie pracy od samego początku z taką biblioteką.

Wybór IronXL od samego początku obejmuje oba scenariusze. Samouczek dotyczący odczytu w IronXL pokazuje, że odczyt za pomocą IronXL jest równie prosty — odwołania do komórek, iteracja zakresów, eksport zestawów danych oraz dostęp do wartości z zachowaniem bezpieczeństwa typów działają za pośrednictwem tego samego, znanego interfejsu API.

Co należy zrobić dalej?

ExcelDataReader jest biblioteką tylko do odczytu. To ograniczenie wynika z projektu i nie ulegnie zmianie. Jeśli Twój projekt wymaga pisania, modyfikowania lub eksportowania plików Excel w dowolnej formie, potrzebujesz biblioteki stworzonej z myślą o dwukierunkowym dostępie do Excela.

IronXL zapewnia tę funkcjonalność bez zależności od pakietu Office, bez złożoności interoperacyjności COM i bez łączenia wielu pakietów w niestabilny stos wielu bibliotek. Zainstaluj go z NuGet, zastąp istniejący kod odczytu odpowiednikami metod IronXL i dodaj operacje zapisu tam, gdzie to konieczne — API jest spójne w obu kierunkach.

Zapoznaj się z dokumentacją IronXL, aby zrozumieć pełny zakres biblioteki IronXL. Zapoznaj się z instrukcjami dotyczącymi konkretnych zadań, takich jak zapisywanie plików Excel, tworzenie arkuszy kalkulacyjnych i odczytywanie istniejących skoroszytów. Gdy będziesz gotowy do oceny licencji produkcyjnych, na stronie z cennikiem i informacjami o licencjach znajdziesz listę wszystkich dostępnych poziomów.