C# CSV-Bibliothek: Vollständiges Tutorial mit IronXL

Wie richtet man eine C#-Tabellenkalkulationsbibliothek ein?

Die Installation von IronXL über NuGet dauert weniger als eine Minute. Öffnen Sie die Paket-Manager-Konsole in Visual Studio und führen Sie den unten stehenden Befehl aus, oder verwenden Sie die .NET Befehlszeilenschnittstelle (CLI) von einem beliebigen Terminal aus:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Nach der Installation des Pakets fügen Sie den Namespace zu jeder Datei hinzu, in der Sie mit Tabellendaten arbeiten möchten:

using IronXL;

using IronXL;

IronXL zielt auf .NET Framework 4.6.2+ und alle modernen .NET Versionen (Core, 5, 6, 7, 8, 9 und 10) ab. Es läuft unter Windows, Linux und macOS und eignet sich daher sowohl für Desktop-Anwendungen als auch für containerisierte Server-Workloads. Im IronXL -Installationshandbuch finden Sie Schritt-für-Schritt-Anweisungen zu Paketquellen und Lizenzaktivierung.

Wie liest man CSV-Dateien in C#?

Das Einlesen einer CSV-Datei mit IronXL folgt dem gleichen Muster wie das Laden einer beliebigen Tabellenkalkulation. Rufen Sie WorkBook.Load mit dem Dateipfad auf, und IronXL leitet das Format aus der Dateiendung ab – keine zusätzliche Konfiguration erforderlich:

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

Das Objekt WorkBook stellt das vollständige Tabellenkalkulationsmodell bereit. Sie greifen auf Zellen mit der gewohnten Excel-Neintation wie "A2" zu, und integrierte Konvertierungseigenschaften -- StringValue, DecimalValue, IntValue, DateTimeValue -- übernehmen die Typumwandlung, sodass Sie Zeichenketten nicht manuell analysieren müssen.

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

Wie schreibt man CSV-Dateien in C#?

Das Erstellen einer CSV-Datei von Grund auf umfasst drei Schritte: Erstellen einer WorkBook, Befüllen einer WorkSheet und Aufrufen einer SaveAsCsv. Der Prozess entspricht dem Erstellen jeder beliebigen Tabellenkalkulation, wodurch die API unabhängig vom Ausgabeformat konsistent bleibt:

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

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

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

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

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

SaveAsCsv kümmert sich um die Platzierung von Trennzeichen, das Einschließen von Feldern, die Kommas enthalten, und die Neinrmalisierung von Zeilenumbrüchen. Sie müssen nichts davon manuell verwalten. IronXL erhält die numerischen Datentypen beim Export, sodass nachgelagerte Tools wie Excel oder pandas die Zahlen als Zahlen und nicht als in Anführungszeichen gesetzte Textzeichenfolgen lesen.

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

Wie konvertiert man in C# zwischen CSV und Excel?

Eine der wertvollsten Funktionen von IronXL ist die bidirektionale Konvertierung zwischen CSV- und Excel-Formaten. Die API ist symmetrisch -- Load liest jedes unterstützte Format, und die Save-Methodenfamilie schreibt in Ihr Zielformat:

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

Diese Konvertierungen gewährleisten die Datenintegrität. Numerische Werte bleiben numerisch, Datumsfelder behalten ihren Datentyp, und Formelergebnisse werden vor dem Speichern auf ihre berechneten Werte ausgewertet. Wenn Sie eine Excel-Datei mit mehreren Tabellenblättern in das CSV-Format konvertieren, erstellt IronXL automatisch für jedes Tabellenblatt eine separate CSV-Datei:

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

Dieses Verhalten ist besonders nützlich für Reporting-Pipelines, bei denen nachgelagerte Empfänger ein Thema pro Datei erwarten. Das Tutorial zum Schreiben von CSV-Dateien behandelt weitere Optionen, wie z. B. die Angabe des Trennzeichens und die Steuerung der in den Export einbezogenen Tabellenblätter.

Starten Sie jetzt mit IronXL.

Jetzt kostenlos starten

Warum reichen reine CSV-Bibliotheken für reale Projekte nicht aus?

Viele C#-Entwickler beginnen mit CsvHelper oder demTextFieldParser aus Microsoft.VisualBasic. Beide sind leistungsfähige Werkzeuge für reine CSV-Workflows. Die Lücke entsteht, wenn sich die Anforderungen erweitern: Ein Stakeholder verlangt einen Excel-Download anstelle einer CSV-Datei, die Finanzabteilung benötigt die Beibehaltung der Formeln, oder die Sicherheitsrichtlinien erfordern passwortgeschützte Dateien. An diesem Punkt zwingt Sie eine reine CSV-Bibliothek dazu, eine zweite Abhängigkeit hinzuzufügen und zwei separate Integrationspfade zu pflegen. Eine einheitliche Tabellenkalkulationsbibliothek beseitigt diese Aufteilung von vornherein.

Was sind Ihre nächsten Schritte?

IronXL bietet Ihnen eine einheitliche API zum Lesen, Schreiben und Konvertieren von CSV- und Excel-Dateien in jeder .NET 10-Anwendung. Die wichtigsten Vorteile liegen auf der Hand: keine Abhängigkeit von Office, plattformübergreifende Unterstützung, starke Typisierung für Zellwerte und ein direkter Weg von reinen CSV-Projekten hin zu vollständiger Tabellenkalkulationsfunktionalität, wann immer sich die Anforderungen ändern.

Wenn Sie bereit sind, tiefer in die Materie einzusteigen, beginnen Sie mit den Themen, die für Ihr aktuelles Projekt am relevantesten sind. Wenn Sie hauptsächlich mit CSV-Importpipelines arbeiten, decken die oben beschriebenen Lese- und Zuordnungsmuster den Großteil der realen Anwendungsfälle ab. Wenn Ihre Ausgabeanforderungen variieren – mal CSV für nachgelagerte Skripte, mal XLSX für Endbenutzer – zeigt der Abschnitt zur Formatkonvertierung, wie Sie beides mit einer einzigen Codebasis bereitstellen können.

Für Teams, die Berichtssysteme erstellen oder Ergebnisse aus Datenbanken exportieren, skaliert der Ansatz InsertDataTable gut und vermeidet den Leistungsaufwand der zeilenweisen Zellenzuweisung. Kombiniert man dies mit Zellformatierungen, lassen sich Berichte erstellen, die Benutzer direkt in Excel öffnen können, ohne sie neu formatieren zu müssen.

Um fortzufahren, befolgen Sie diese Schritte:

1. Installieren Sie die Bibliothek über NuGet mit Install-Package IronXL oder dotnet add package IronXL.
2. Folgen Sie der Kurzanleitung im IronXL Leitfaden für Einsteiger, um Ihre erste CSV-Datei zu laden.
3. Wenn Sie beide Formate im selben Projekt benötigen, können Sie mithilfe des Tutorials "CSV zu Excel" die Formatkonvertierung erkunden .
4. Informationen zu erweiterten Zelloperationen, Formelunterstützung und Formatierung finden Sie in der API-Referenz unter IronXL Objektreferenz .
5. Starten Sie eine kostenlose Testphase auf der IronXL Testlizenzseite – keine Kreditkarte erforderlich, inklusive technischem Support.

Wenn Sie Optionen zusammen mit anderen Iron Software Tools evaluieren, umfasst die IronSoftware-Produktpalette die PDF-Generierung mit IronPDF , Barcode-Lesen, OCR und mehr – alle teilen sich das gleiche Lizenzmodell und den gleichen Supportkanal.