C# CSV-Reader und -Writer: Erstellen, Exportieren und Konvertieren von CSV-Dateien mit IronXL

Was ist das CSV-Format und warum ist es wichtig?

Eine CSV-Datei (Comma Separated Values) ist eines der am häufigsten verwendeten Formate zum Speichern und Austauschen von Tabellendaten zwischen verschiedenen Anwendungen. In ihrer einfachsten Form ist eine CSV-Datei eine reine Textdatei, in der jede Zeile eine Reihe von durch Kommas getrennten Werten enthält. Dank dieser einfachen Struktur lassen sich CSV-Daten leicht erstellen, lesen und in einer Vielzahl von Softwaresystemen verarbeiten.

Das CSV-Format ist sowohl leichtgewichtig als auch gut lesbar, weshalb es eine beliebte Wahl für den Export von Berichten, die Datenübertragung zwischen Datenbanken und die Integration mit Analysetools ist. Jede Zeile in einer CSV-Datei stellt einen einzelnen Datensatz dar, und die einzelnen Werte innerhalb dieser Zeile sind durch Kommas getrennt. Die erste Zeile der Datei dient normalerweise als Kopfzeile, in der die Namen der einzelnen Spalten aufgeführt sind. Jede nachfolgende Zeile enthält die eigentlichen Daten, wobei jeder Wert einer Spalte in der Kopfzeile entspricht.

Das Verständnis der Struktur von CSV-Dateien hilft Ihnen, bessere Entscheidungen hinsichtlich der Wahl des Trennzeichens, der Zeichenmaskierung und der Kodierung zu treffen – alles Faktoren, die Einfluss darauf haben, ob nachgelagerte Systeme Ihre Ausgabe zuverlässig parsen können. Das CSV-Dateiformat ist in RFC 4180 definiert, der auch Hinweise zum Umgang mit Sonderfällen wie eingebetteten Kommas, Zeilenumbrüchen innerhalb von Feldern und in Anführungszeichen gesetzten Zeichenkettenwerten enthält.

Wie installiert man IronXL in einem .NET Projekt?

Das Hinzufügen von IronXL zu einem neuen Projekt dauert über NuGet, den Paketmanager von Microsoft for .NET, nur wenige Sekunden. Öffnen Sie Visual Studio, rufen Sie die NuGet-Paketmanager-Konsole auf und führen Sie den folgenden Befehl aus:

Install-Package IronXl.Excel

Alternativ können Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt klicken, "NuGet-Pakete verwalten" auswählen, auf der Registerkarte Durchsuchen nach "IronXL" suchen und auf Installieren klicken. IronXL unterstützt .NET Framework 4.6.2+, .NET Core, .NET 5/6/7/8/10 und läuft auf jeder Plattform ohne externe Abhängigkeiten oder COM-Interop-Anforderungen.

Nach der Installation fügen Sie den IronXL Namespace mithilfe der Anweisung using zu Ihrer Codedatei hinzu:

using IronXL;

using IronXL;

Dieser einzige Namespace bietet Zugriff auf alle Klassen, die für die Erstellung von Tabellenkalkulationen und den CSV-Export benötigt werden. Im Gegensatz zu Ansätzen, die auf StreamWriter oder StringBuilder zum manuellen Schreiben von CSV-Dateien angewiesen sind, übernimmt IronXL die gesamte Komplexität der korrekten CSV-Formatierung automatisch – einschließlich des Maskierens von Sonderzeichen, der Beibehaltung der Datentypen und der Auswertung von Formeln vor dem Export.

Die IronXL Dokumentation deckt die gesamte API-Oberfläche ab, einschließlich erweiterter Funktionen wie Zellstyling, Formelauswertung, Passwortschutz und Diagrammerstellung. Als schnelle Referenz bietet die IronXL -Beispielbibliothek sofort ausführbare Codebeispiele, die Dutzende gängiger Tabellenkalkulationsszenarien abdecken.

Wie erstellt man eine neue CSV-Datei von Grund auf?

Das programmgesteuerte Erstellen einer neuen CSV-Datei umfasst drei Schritte: das Erstellen einer Arbeitsmappe, das Befüllen mit Daten und das Speichern im CSV-Format. Die API von IronXL bildet das bekannte Excel-Objektmodell nach und erleichtert es Entwicklern, Code zu schreiben, der mit Tabellenkalkulationskonzepten in einer Konsolenanwendung oder einem beliebigen .NET Projekttyp funktioniert.

Stellen Sie sich vor, Sie müssen eine Liste von Mitarbeiterdatensätzen als CSV-Datei exportieren. Hier ist ein vollständiges Beispiel mit Anweisungen auf oberster Ebene:

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

Die Methode WorkBook.Create() initialisiert eine neue Tabellenkalkulation vollständig im Arbeitsspeicher, sodass bis zum endgültigen Speichervorgang keine temporären Dateien oder Datenträger-Ein-/Ausgabe erforderlich sind. Die Methode CreateWorkSheet() fügt der Arbeitsmappe ein benanntes Arbeitsblatt hinzu - dieser Name wird relevant, wenn Arbeitsmappen mit mehreren Tabellenblättern in das CSV-Format exportiert werden.

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

workBook.SaveAsCsv("students.csv", ",");

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

workBook.SaveAsCsv("students.csv", ",");

Wie konvertiert man eine bestehende Excel-Datei in eine CSV-Datei?

Die Konvertierung von Excel-Tabellen in das CSV-Format ist eine häufige Anforderung bei der Integration von Altsystemen, der Vorbereitung von Daten für Datenbankimporte oder der Generierung von maschinenlesbaren Ausgaben aus von Menschen erstellten Berichten. IronXL wickelt diese Konvertierung mit minimalem Code ab, wobei die Datengenauigkeit erhalten bleibt.

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

Die Methode Load() öffnet Excel-Dateien in verschiedenen Formaten, darunter XLSX, XLS, XLSM und sogar bestehende CSV- oder TSV-Dateien. Diese Flexibilität ermöglicht es Ihnen, standardisierte Export-Pipelines zu erstellen, die Eingabedateien unabhängig von ihrem ursprünglichen Format akzeptieren. Die vollständige Liste der unterstützten Excel-Formate finden Sie in der IronXL -Dokumentation.

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

Wie exportiert man eine DataTable in das CSV-Format?

Unternehmensanwendungen arbeiten häufig mit DataTable-Objekten, die aus Datenbankabfragen, API-Antworten oder der Datenverarbeitung im Arbeitsspeicher stammen. IronXL überbrückt die Lücke zwischen diesen .NET-Datenstrukturen und Dateiexporten und bietet einen zuverlässigen Pfad vom Anwendungsspeicher zu gemeinsam nutzbaren CSV-Dateien. Diese Methode ist zuverlässiger als das manuelle Schreiben von CSV-Dateien mit StreamWriter, da IronXL die Zeichenmaskierung, die Trennzeichenverwaltung und die Kodierung automatisch übernimmt.

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

Dieses Muster durchläuft die DataTable Struktur, wobei zuerst die Spaltenüberschriften übertragen und anschließend jede Datenzeile systematisch befüllt wird. Die Eigenschaft DefaultWorkSheet ermöglicht den schnellen Zugriff auf das erste Arbeitsblatt in einer neu erstellten Arbeitsmappe, wodurch in einfachen Fällen die explizite Erstellung eines Arbeitsblatts entfällt.

Wie geht man mit benutzerdefinierten Trennzeichen in CSV-Dateien um?

Verschiedene Systeme und regionale Standards erfordern unterschiedliche Begrenzungszeichen. Während das Komma in vielen Ländern das Standard-Trennzeichen ist, wird in europäischen Regionen, in denen das Komma als Dezimaltrennzeichen in numerischen Werten dient, oft das Semikolon bevorzugt. Tabulatorgetrennte Dateien (TSV) sind beliebt, wenn die Quelldaten Kommas in den Feldwerten enthalten. Die Methode SaveAsCsv() von IronXL deckt all diese Szenarien ab, ohne dass zusätzlicher Code zur Verarbeitung jeder Ausgabezeile erforderlich ist.

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

Der zweite Parameter von SaveAsCsv() akzeptiert eine beliebige Zeichenkette als Trennzeichen und bietet somit volle Flexibilität für die Integration mit verschiedenen Systemen und regionalen Anforderungen. Bei der Erstellung von Dateien für die internationale Verteilung sollten die lokalen Erwartungen des Zielsystems berücksichtigt werden – europäische Finanzsysteme erwarten häufig eine Trennung durch Semikolon, während nordamerikanische Systeme in der Regel Kommas verwenden. Der RFC 4180-Standard für CSV beschreibt, wie Werte, die Trennzeichen enthalten, in Anführungszeichen gesetzt werden sollten, um Parsing-Fehler zu vermeiden.

Was sind die Best Übens für die CSV-Dateigenerierung in C#?

Bei der Arbeit mit CSV-Dateien in C# gewährleistet die Einhaltung etablierter Vorgehensweisen, dass Ihre Daten korrekt, lesbar und mit anderen Systemen kompatibel bleiben. Die folgende Tabelle fasst die wichtigsten Überlegungen zusammen:

Über die Grundlagen hinaus sollten Sie bei der Ansprache internationaler Zielgruppen eine explizite Kodierung in Betracht ziehen. UTF-8 mit BOM ist oft erforderlich, damit CSV-Dateien in Microsoft Excel Nicht-ASCII-Zeichen korrekt anzeigen können. Bei großen Exportmengen mit Millionen von Zeilen empfiehlt es sich, die Daten in mehrere Dateien aufzuteilen, anstatt eine einzige große CSV-Datei zu schreiben – dadurch bleiben die Dateigrößen überschaubar und der Speicherbedarf wird sowohl bei der Generierung als auch bei der Verwendung reduziert.

Für Teams, die Datenpipelines erstellen, bietet die IronXL Dokumentation zu asynchronen und Streaming- Verfahren Anleitungen zum Umgang mit großen Datensätzen, ohne ganze Arbeitsmappen in den Speicher laden zu müssen. Die IronXL -Beispielbibliothek enthält zusätzliche Muster für die Stapelverarbeitung, geplante Exportaufträge und die Integration mit gängigen ORM-Frameworks wie Entity Framework.

Bei der Arbeit mit den CSV-Verarbeitungswerkzeugen des .NET Ökosystems hilft Ihnen das Verständnis dafür, wo IronXL im Verhältnis zu den Low-Level-Ansätzen einzuordnen ist, dabei, für jedes Szenario das richtige Werkzeug auszuwählen. Für die reine CSV-Generierung ohne Beteiligung von Excel kann StreamWriter mit manueller Anführungszeichenlogik ausreichend sein. Für alles, was mit Excel-Formatkompatibilität, Formelauswertung oder umfangreicher Formatierung zu tun hat, bietet IronXL eine zuverlässigere Grundlage.

Wie liest man eine bestehende CSV-Datei mit IronXL ein?

Das Einlesen von CSV-Daten in Ihre Anwendung folgt dem gleichen Muster wie das Laden anderer Tabellenkalkulationsformate. Die Methode Load() von IronXL erkennt CSV-Dateien und parst sie in das Standard-Arbeitsmappen-/Arbeitsblattmodell, wodurch Sie über dieselbe API, die auch für Excel-Dateien verwendet wird, auf einzelne Zellen und Bereiche zugreifen können.

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

Durch diese Konsistenz zwischen Lese- und Schreibvorgängen muss Ihr Team nur eine einzige API für alle tabellenkalkulationsbezogenen Aufgaben erlernen. Die gleiche Methode WorkBook.Load(), die CSV-Dateien öffnet, verarbeitet auch die Formate XLSX, XLS und XLSM – nützlich beim Erstellen von Pipelines, die Eingaben in mehreren Formaten akzeptieren. Mehr über das Lesen von CSV-Dateien mit IronXL erfahren Sie in der Dokumentation.

Was sind Ihre nächsten Schritte?

Dieser Leitfaden behandelte die wichtigsten Muster für die Erstellung und Verwaltung von CSV-Dateien mit IronXL in C#:

• WorkBook.Create() zum Initialisieren neuer Tabellenkalkulationen im Speicher
• WorkBook.Load() zum Öffnen vorhandener Excel- und CSV-Dateien in jedem unterstützten Format
• SaveAsCsv() zum Exportieren von Daten mit anpassbaren Trennzeichen
• Export einzelner Arbeitsblätter mit GetWorkSheet() für gezielte Konvertierungen
• DataTable Iterationsmuster für Datenbank-zu-CSV-Workflows
• Export der Objektliste mithilfe von foreach Schleifen
• Einlesen von CSV-Daten in Ihre Anwendung mit vollem Zugriff

Um diese Techniken in die Praxis umzusetzen, starten Sie eine kostenlose IronXL Testversion , um den vollen Funktionsumfang der Tabellenkalkulation ohne zeitliche Begrenzung zu erkunden. Wenn Sie bereit für den Produktiveinsatz sind, sollten Sie die IronXL -Lizenzoptionen prüfen, um den richtigen Plan für Ihre Teamgröße und Ihre Nutzungsanforderungen zu finden.

Weitere Beispiele für fortgeschrittene Szenarien wie Zellformatierung, Formelerstellung, Diagrammgenerierung und Passwortschutz finden Sie in der IronXL Dokumentation und der vollständigen Codebeispielbibliothek . Die IronXL Tutorialreihe behandelt komplexere Integrationsszenarien, darunter DataTable-Exporte , Formatkonvertierungen und das Schreiben in CSV-Dateien .