ExcelDataReader Excel-Dateien schreiben: Warum es nicht geht und wie IronXL das Problem löst

Kann ExcelDataReader Excel-Arbeitsmappen-Daten schreiben?

Nein. ExcelDataReader ist von Grund auf eine schreibgeschützte Bibliothek, und diese Einschränkung ist beabsichtigt. Im offiziellen ExcelDataReader GitHub Repository wird das Projekt ausdrücklich als "eine Bibliothek zum Lesen von Microsoft Excel-Dateien" beschrieben – es gibt keine Schreib-API, keine Speichermethode und keine Möglichkeit, Zellwerte an der öffentlichen Schnittstelle festzulegen. Sie können dies selbst überprüfen, indem Sie die Seite des NuGet Pakets ExcelDataReader besuchen, wo die Paketbeschreibung den Nur-Lese-Bereich nochmals unterstreicht.

ExcelDataReader unterstützt die Formate XLS, XLSX und CSV zum Lesen und erledigt diese Aufgabe effizient. Die Bibliothek stellt ein Streaming-Reader-Muster bereit, das nur vorwärts liest und dem IDataReader in .NET ähnelt. Diese Architektur eignet sich gut für die schnelle Extraktion großer Datensätze, ist aber grundsätzlich unvereinbar mit dem für Excel-Schreibvorgänge erforderlichen Modell des wahlfreien Zugriffs und der Veränderbarkeit.

Der folgende Code veranschaulicht die Grenzen, an die man mit ExcelDataReader stößt:

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
}

Nach dem Aufruf von Read() gibt es schlichtweg kein äquivalentes Gegenstück Write() oder Save(). Wenn Ihre Anwendung Berichte erstellen, Tabellenzellen aktualisieren, Daten in das XLSX-Format exportieren, Formeln anwenden oder Vorlagen verarbeiten muss, bietet Ihnen ExcelDataReader nur eine leere Werkzeugkiste.

Das ist kein Fehler. Es handelt sich um eine bewusste Entscheidung hinsichtlich des Untersuchungsgegenstands. ExcelDataReader kann eine Sache gut und das war's dann auch schon. Für jeden Workflow, der das Zurückschreiben von Daten nach Excel beinhaltet, wird eine völlig andere Bibliothek benötigt.

Wie löst IronXL das Schreibproblem?

IronXL bietet eine einheitliche API zum Lesen, Erstellen, Ändern und Speichern von Excel-Dateien ohne Installation von Microsoft Office. Die Bibliothek behandelt eine Excel-Arbeitsmappe als einen vollständig veränderlichen, im Arbeitsspeicher befindlichen Objektgraphen. Sie laden oder erstellen eine Arbeitsmappe, navigieren über einen Bezug zu einer beliebigen Zelle, legen Werte oder Formeln fest, wenden Formatvorlagen an und rufen dann SaveAs() auf – einen Arbeitsablauf, der die Arbeitsweise eines Menschen in Excel widerspiegelt.

IronXL unterstützt die Formate XLSX, XLS, CSV, TSV und JSON sowohl für die Ein- als auch für die Ausgabe. Es läuft unter .NET 10, .NET Standard und .NET Framework und eignet sich daher gleichermaßen für Konsolenanwendungen, ASP.NET Core Web-APIs, Desktop-Tools und Hintergrundverarbeitungsdienste.

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.");

Wie liest und schreibt man in einem einzigen IronXL Workflow?

Eine häufige Anforderung ist es, eine bestehende Excel-Datei einzulesen, ihre Daten zu transformieren und die Ergebnisse zurückzuschreiben. ExcelDataReader übernimmt nur den ersten Schritt, was bedeutet, dass Sie eine zweite Bibliothek einführen müssen – eine unnötige Komplikation, die zusätzlichen Aufwand für die Abhängigkeitsverwaltung und potenzielle Versionskonflikte mit sich bringt.

IronXL deckt die gesamte Pipeline ab. Das folgende Beispiel lädt eine Quelldatei, liest Werte aus Spalte A, transformiert diese und speichert die geänderte Arbeitsmappe als neue Datei:

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.Neinw.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.Neinw.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

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

Der Aufruf WorkBook.Load() liest die Datei als veränderliches Objekt in den Speicher ein. Anschließend navigieren Sie mithilfe von Excel-ähnlichen Verweisen durch die Zellen, aktualisieren Werte, legen Formeln fest und speichern – alles innerhalb einer einzigen Bibliothek und eines einzigen API-Musters.

Welche erweiterten Schreibfunktionen unterstützt IronXL ?

Über die einfache Zellenzuordnung hinaus bietet IronXL die gesamte Bandbreite an Excel-Funktionen, die Geschäftsanwendungen typischerweise benötigen.

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");

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.");

Wie vergleicht man ExcelDataReader und IronXL im direkten Vergleich?

Die folgende Tabelle fasst die Funktionsunterschiede der beiden Bibliotheken in den gängigsten Excel-Entwicklungsszenarien zusammen:

ExcelDataReader bleibt eine legitime Wahl, wenn nur das Lesen erforderlich ist und die Binärgröße von Bedeutung ist. Für jedes Szenario, das mit der Ausgabe von Daten zu tun hat, ist IronXL das geeignete Werkzeug.

Wann sollten Sie IronXL verwenden?

IronXL ist die richtige Wahl, wenn Ihre Anwendung Excel-Dateien erstellen oder bearbeiten muss. Die folgenden Szenarien sind beispielhaft für reale Geschäftsanforderungen, die ExcelDataReader nicht erfüllen kann:

• Berichtserstellung: Erstellen Sie Excel-Berichte aus Datenbankabfragen, API-Antworten oder Berechnungen im Arbeitsspeicher. Eine detaillierte Schritt-für-Schritt-Anleitung finden Sie im Leitfaden zur Erstellung von Excel-Berichten .
• Datenexport: Konvertieren Sie Anwendungsdaten – Sammlungen, DataTables oder DataSets – in das XLSX-Format zum Herunterladen oder Archivieren. Das Tutorial "DataTable zu Excel" zeigt die genaue API.
• Vorlagenverarbeitung: Laden Sie eine XLSX-Vorlage mit Platzhalterzellen, füllen Sie diese dynamisch aus und speichern Sie anschließend das Ergebnis.
• Stapelverarbeitung von Dateien: Durchlaufen Sie ein Verzeichnis mit Arbeitsmappen, wenden Sie die Änderungen programmgesteuert an und speichern Sie jede Datei. IronXL verarbeitet mehrere geöffnete Arbeitsmappen unabhängig voneinander.
• Erstellung von Rechnungen und Finanzdokumenten: Strukturierte Dokumente mit Formeln, Zahlenformatierung, verbundenen Zellen und formatierten Kopfzeilen erstellen.
• CSV-zu-XLSX-Konvertierung: Kommagetrennte Uploads akzeptieren, diese als strukturierte Arbeitsmappen formatieren und den Benutzern als XLSX-Downloads zur Verfügung stellen.

Geschäftsanwendungen, die bisher eine Lesebibliothek plus eine Schreibbibliothek oder eine Abhängigkeit von der Excel-Automatisierung über COM benötigten, können nun auf IronXL allein umgestellt werden.

Für fortgeschrittene Ausgabeszenarien decken die Dokumentation zur bedingten Formatierung und der Leitfaden zur Diagrammerstellung das gesamte Spektrum der Formatierungs- und Visualisierungsmöglichkeiten ab. Auf der Lizenzierungsseite werden die Optionen für den Produktionseinsatz beschrieben, und die vollständige API-Referenz dokumentiert jede Klasse und Methode.

Wie starte ich eine kostenlose Testphase?

IronXL ist unter einer kostenlosen Entwicklerlizenz erhältlich. Installieren Sie das NuGet Paket, führen Sie die obigen Beispiele mit Ihren eigenen Dateien aus und überprüfen Sie, ob die Ausgabe Ihren Anforderungen entspricht, bevor Sie eine Produktionslizenz erwerben.

Die IronXL Einführungsanleitung führt Sie durch die Installation, erste Anwendungsfälle und gängige Szenarien mit ausführbarem Code. Der Abschnitt "Tutorials" behandelt Lese-Workflows im Detail, was nützlich ist, wenn Ihre Anwendung sowohl Lese- als auch Schreibvorgänge benötigt.

Starten Sie die kostenlose Testphase , um auf den vollen Funktionsumfang zuzugreifen, einschließlich Exportformate, erweiterte Formatierung, Formelauswertung und Verwaltung von Arbeitsmappen mit mehreren Tabellenblättern. Für Teams, die die Bibliothek in großem Umfang evaluieren, enthält das IronSuite-Paket IronXL sowie IronPDF, IronOCR und weitere Produktivitätsbibliotheken zu einem reduzierten Gesamtpreis.

Lohnt sich die Verwendung von ExcelDataReader noch?

ExcelDataReader ist eine gut gepflegte Open-Source-Bibliothek mit einem klaren Zweck. Wenn Ihre Anwendung ausschließlich Excel-Dateien liest und nie schreibt – beispielsweise eine Datenaufnahmepipeline, die XLSX-Uploads in eine Datenbank importiert – ist ExcelDataReader eine sinnvolle und ressourcenschonende Wahl. Sein Streaming-Modell ist auch bei sehr großen Dateien speichereffizient.

Das Problem entsteht, wenn die Anforderungen steigen. Anwendungen, die als reine Leseimporteure beginnen, entwickeln sich oft weiter und erzeugen Bestätigungsexporte, Fehlerberichte oder modifizierte Kopien der Originaldateien. An diesem Punkt wird die Bereichsgrenze von ExcelDataReader zum Hindernis, und die Migration zu einer Lese-/Schreibbibliothek mitten im Projekt ist störender als der Beginn mit einer solchen Bibliothek.

Mit der Wahl von IronXL von Anfang an sind beide Szenarien abgedeckt. Das IronXL Lese-Tutorial zeigt, dass das Lesen mit IronXL genauso unkompliziert ist – Zellbezüge, Bereichsiteration, DataSet-Export und typsicherer Wertzugriff funktionieren alle über die gleiche vertraute API.

Was sollten Sie als Nächstes tun?

ExcelDataReader ist eine schreibgeschützte Bibliothek. Diese Einschränkung ist beabsichtigt und wird sich nicht ändern. Wenn Ihr Projekt das Schreiben, Ändern oder Exportieren von Excel-Dateien in irgendeiner Form erfordert, benötigen Sie eine Bibliothek, die für den bidirektionalen Zugriff auf Excel entwickelt wurde.

IronXL bietet diese Funktionalität ohne Office-Abhängigkeiten, ohne COM-Interoperabilitätskomplexität und ohne die Kombination mehrerer Pakete zu einem fragilen Multi-Bibliotheks-Stack. Installieren Sie es von NuGet, ersetzen Sie Ihren bestehenden Lesecode durch die entsprechenden Methoden von IronXL und fügen Sie bei Bedarf Schreibvorgänge hinzu – die API ist in beide Richtungen konsistent.

Um den vollen Umfang der Bibliothek zu verstehen, lesen Sie die IronXL -Dokumentation . Lesen Sie die Anleitungen für spezifische Aufgaben wie das Schreiben von Excel-Dateien , das Erstellen von Tabellenkalkulationen und das Lesen vorhandener Arbeitsmappen . Wenn Sie bereit sind, die Produktionslizenzierung zu bewerten, finden Sie auf der Seite "Preise und Lizenzierung" alle verfügbaren Stufen.