C# Speichern in CSV mit IronXL

Einführung in kommagetrennte Werte

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 für Menschen lesbar, weshalb es eine beliebte Wahl für den Export von Berichten, die Übertragung von Daten zwischen Datenbanken und die Integration mit Analysetools ist.

Verständnis des CSV-Formats

Das CSV-Format ist auf Einfachheit ausgelegt: Jede Zeile in einer CSV-Datei stellt einen einzelnen Datensatz dar, und jeder Wert innerhalb dieser Zeile wird durch ein Komma 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. Diese Struktur ermöglicht es CSV-Dateien, komplexe Datentabellen in einem Format darzustellen, das sowohl leicht zu lesen als auch leicht zu analysieren ist.

Wie installiere ich IronXL in meinem Projekt?

Das Hinzufügen von IronXL zu einem neuen Projekt dauert nur ein paar Sekunden über NuGet-Pakete, Microsofts Paketmanager für .NET. Ö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 und läuft auf jeder Plattform ohne externe Abhängigkeiten oder COM-Interop-Anforderungen.

Nach der Installation fügen Sie den IronXL-Namensraum mit der Anweisung using in Ihre Codedatei ein:

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 sich auf die StreamWriter-Klasse oder den StringBuilder verlassen, um CSV-Dateien manuell zu schreiben, bewältigt IronXL die gesamte Komplexität der richtigen CSV-Formatierung automatisch.

Wie kann ich eine neue CSV-Datei von Grund auf neu erstellen?

Das programmgesteuerte Erstellen einer neuen CSV-Datei umfasst drei einfache Schritte: Erstellen einer Arbeitsmappe, Befüllen mit Daten und Speichern im CSV-Format. Die intuitive API von IronXL spiegelt das vertraute Excel-Objektmodell wider und macht es Entwicklern leicht, Code zu schreiben, der mit Tabellenkalkulationskonzepten in einer Konsolenanwendung oder einem beliebigen .NET-Projekttyp arbeitet.

Stellen Sie sich ein Szenario vor, in dem Sie eine Liste von Mitarbeiterobjekten in eine CSV-Datei exportieren müssen. Hier ist ein vollständiges Beispiel, das zeigt, wie man CSV-Daten schreibt:

using IronXL;
class Program
{
 public static void Main(string[] args)
 {
  // 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 - output goes to the specified path
  workBook.SaveAsCsv("employees.csv", ",");
 }
}

using IronXL;
class Program
{
 public static void Main(string[] args)
 {
  // 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 - output goes to the specified path
  workBook.SaveAsCsv("employees.csv", ",");
 }
}

Die Methode WorkBook.Create() initialisiert ein neues Arbeitsblatt vollständig im Speicher, so dass bis zum abschließenden Speichervorgang keine temporären Dateien oder Festplatten-E/A erforderlich sind. Die Methode CreateWorkSheet() fügt der Arbeitsmappe ein benanntes Arbeitsblatt hinzu - dieser Name wird später beim Exportieren von Arbeitsmappen mit mehreren Blättern in CSV-Dateien relevant.

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; }
}
// In your program class or method
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; }
}
// In your program class or method
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 konvertiere ich eine bestehende Excel-Datei in CSV?

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. Die Datei befindet sich auf der Festplatte und kann direkt geladen werden.

using IronXL;

// Load an existing Excel file from the specified location
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 from the specified location
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 vorhandene CSV- oder TSV-Dateien. Diese Flexibilität bedeutet, dass Entwickler standardisierte Export-Pipelines erstellen können, die Eingabedateien unabhängig von ihrem ursprünglichen Format akzeptieren. Das System verwaltet die Dateioperationen intern.

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
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
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 exportiere ich eine DataTable in CSV?

Unternehmensanwendungen arbeiten häufig mit DataTable-Objekten, die aus Datenbankabfragen, API-Antworten oder In-Memory-Datenverarbeitung gefüllt werden. 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 robuster als das manuelle Schreiben von CSV-Dateien mit einem var-Writer-Ansatz oder die Verwendung eines neuen StreamWriter.

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 a loop
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 and save to the specified path
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 a loop
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 and save to the specified path
workBook.SaveAsCsv("product_inventory.csv", ",");

Dieses Muster durchläuft die DataTable-Struktur, indem es zuerst die Spaltenüberschriften überträgt und dann jede Datenzeile systematisch auffüllt. Die Eigenschaft DefaultWorkSheet ermöglicht einen schnellen Zugriff auf das erste Arbeitsblatt in einer neu erstellten Arbeitsmappe, wodurch die explizite Erstellung von Arbeitsblättern in einfachen Szenarien überflüssig wird. Standardmäßig verarbeitet die Methode alle Zeilen nacheinander.

Wie behandle ich benutzerdefinierte Trennzeichen in CSV-Dateien?

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 SaveAsCsv()-Methode von IronXL eignet sich für alle diese Szenarien, ohne dass zusätzlicher Code für die Verarbeitung jeder einzelnen 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 so vollständige Flexibilität für die Integration mit verschiedenen Systemen und regionalen Anforderungen. Berücksichtigen Sie bei der Erstellung von Dateien für den internationalen Vertrieb die Erwartungen des Zielsystems - europäische Finanzsysteme erwarten häufig eine Semikolontrennung, während nordamerikanische Systeme in der Regel Kommas verwenden.

Bewährte Verfahren

Wenn Sie mit CSV-Dateien in C# arbeiten, sollten Sie sich an bewährte Verfahren halten, um sicherzustellen, dass Ihre Daten korrekt, lesbar und mit anderen Systemen kompatibel bleiben. Hier sind einige wesentliche Richtlinien:

• Einheitliche Begrenzungszeichen: Verwenden Sie in Ihrer CSV-Datei immer ein einheitliches Trennzeichen, z. B. ein Komma oder Semikolon. Dadurch werden beim Importieren oder Exportieren von Daten Parsing-Fehler vermieden.
• Besondere Werte zitieren: Wenn Ihre Datenwerte Kommas, Anführungszeichen oder andere Sonderzeichen enthalten, schließen Sie sie in doppelte Anführungszeichen ein, um die Integrität Ihrer CSV-Daten zu wahren.
• Datums- und Zeitformate: Verwenden Sie in Ihren CSV-Dateien ein einheitliches Datums- und Zeitformat, um Verwechslungen zu vermeiden und die Kompatibilität mit anderen Anwendungen zu gewährleisten.
• Vermeiden Sie Zeilenumbrüche in Werten: Vermeiden Sie Zeilenumbrüche innerhalb von Werten, da diese die Zeilenstruktur stören und Formatierungsprobleme verursachen können.
• Bibliotheken nutzen: Nutzen Sie Bibliotheken wie CsvHelper, um das Lesen und Schreiben von CSV-Dateien zu vereinfachen. CsvHelper behandelt viele der komplexen Eigenschaften des CSV-Formats, wie z. B. Escaping, Quoting und benutzerdefinierte Trennzeichen.
• Dateibehandlung: Prüfen Sie vor dem Schreiben immer, ob die Datei existiert, und behandeln Sie Ausnahmen angemessen. Verwenden Sie die Anweisung using, um sicherzustellen, dass Dateiströme nach der Verwendung ordnungsgemäß geschlossen und entsorgt werden.

Sie können zum Beispiel ein neues Projekt in Visual Studio starten, das NuGet-Paket CsvHelper installieren und die Klasse CsvWriter verwenden, um Daten in eine CSV-Datei zu schreiben. Definieren Sie eine Klasse Student mit Eigenschaften wie Vorname und Nachname und exportieren Sie dann eine Liste von Student-Objekten in eine CSV-Datei mit CsvWriter. Dieser Ansatz rationalisiert nicht nur Ihren Arbeitsablauf, sondern verringert auch das Fehlerrisiko und stellt sicher, dass Ihre CSV-Dateien gut strukturiert sind und in jeder Anwendung verwendet werden können.

Abschluss

Das Erstellen und Exportieren von CSV-Dateien in C# wird mit IronXL bemerkenswert effizient. Von der Generierung neuer Dateien mit strukturierten Daten bis hin zur Konvertierung komplexer Excel-Arbeitsmappen mit mehreren Blättern bietet die Bibliothek eine saubere, intuitive API, die die zugrunde liegende Komplexität der korrekten CSV-Formatierung, der Umkehrung von Sonderzeichen und der Formelauswertung bewältigt. Im Gegensatz zu manuellen Ansätzen, die das Schreiben von benutzerdefiniertem Code mit var stream- und var csv-Variablen oder das Anhängen von Textlogik erfordern, rationalisiert IronXL den gesamten Prozess.

Zu den wichtigsten Methoden und Techniken, die in diesem Beitrag behandelt werden, gehören:

• WorkBook.Create() zum Initialisieren neuer Tabellenblätter im Speicher
• WorkBook.Load() zum Öffnen vorhandener Excel-Dateien in jedem unterstützten Format
• SaveAsCsv() für den Export von Daten mit anpassbaren Begrenzungszeichen
• Export einzelner Arbeitsblätter mit GetWorkSheet() für gezielte Konvertierungen
• DataTable-Iterationsmuster für Datenbank-zu-CSV-Workflows
• Export von Objektlisten mit foreach-Schleifen

Starten Sie Ihre kostenlose Testversion, um die volle Bandbreite der Tabellenkalkulationsfunktionen zu erkunden, oder erwerben Sie eine Lizenz für den Produktionseinsatz. Weitere Beispiele für fortgeschrittene Szenarien wie Zellgestaltung, Formelerstellung und Diagrammerzeugung finden Sie in der umfassenden IronXL-Dokumentation und der Codebeispiele-Bibliothek.