CSV-Dateien ermöglichen den Datenaustausch in unzähligen .NET Anwendungen – und die Standardbibliotheksoptionen stoßen oft an ihre Grenzen, wenn es um die Bewältigung komplexer Daten in der Praxis geht. Von Finanzberichten bis hin zu Warenwirtschaftssystemen können Sie CSV-Dateien programmatisch mit nur wenigen Codezeilen erstellen. Während Bibliotheken wie CsvHelper grundlegende CSV-Operationen abdecken, stehen moderne Entwickler vor komplexen Szenarien: Konvertierung von Excel-Arbeitsmappen mit Formeln, Erhalt der Datentypen beim Export und Umgang mit unternehmensgerechten Tabellenkalkulations-Workflows. IronXL begegnet diesen Herausforderungen, indem es zuverlässiges CSV-Schreiben mit voller Excel-Funktionalität in einer einzigen, unabhängigen Bibliothek kombiniert, die den RFC 4180-Standards entspricht.
Dies macht es ideal für Entwickler, die einen benutzerdefinierten .NET CSV-Writer oder .NET CSV-Parser erstellen, der mehrere Spalten, zeilenspezifische Verarbeitungslogik und automatisch abgeleitete Trennzeichen unterstützt. Dieses Tutorial führt Sie durch die CSV-Funktionen von IronXL – von der einfachen Dateierstellung bis hin zum Datenexport im Unternehmensmaßstab.
Die Installation von IronXL über den NuGet -Paketmanager dauert nur wenige Sekunden. Sie können entweder die Paket-Manager-Konsole oder die .NET -Befehlszeilenschnittstelle verwenden:
Nach der Installation fügen Sie den IronXL -Namespace hinzu und beginnen sofort mit dem Schreiben von CSV-Dateien. Das folgende Beispiel zeigt, wie man in .NET 10 mithilfe von Anweisungen auf oberster Ebene eine Arbeitsmappe erstellt, sie mit Daten füllt und in eine CSV-Datei exportiert:
using IronXL;
// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("data");
// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";
// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;
workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;
workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;
// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");Imports IronXL
' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("data")
' Add headers
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"
' Add data rows
workSheet("A2").Value = "Widget"
workSheet("B2").Value = 100
workSheet("C2").Value = 19.99
workSheet("A3").Value = "Gadget"
workSheet("B3").Value = 250
workSheet("C3").Value = 34.5
workSheet("A4").Value = "Component"
workSheet("B4").Value = 75
workSheet("C4").Value = 8.99
' Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",")Dieses einfache Programm zeigt, wie Sie CSV-Inhalte direkt aus Ihrem C#-Code schreiben und dabei ein WorkBook-Objekt erstellen, das Ihre Daten enthält. Die Methode SaveAsCsv verwendet standardmäßig ein Komma als Trennzeichen, ermöglicht aber die Angabe eines beliebigen Trennzeichens – nützlich für länderspezifische Szenarien, in denen Semikolons oder Tabulatoren das Standard-Spaltentrennzeichen sind.
IronXL organisiert Daten über eine Arbeitsmappen-zu-Arbeitsblatt-Hierarchie. Eine Arbeitsmappe dient als Container für ein oder mehrere Arbeitsblattobjekte , die jeweils ein Raster von Zellen darstellen. Beim Exportieren nach CSV erstellt IronXL eine Datei pro Arbeitsblatt und benennt sie nach dem Muster filename.SheetName.csv.
Dieses Modell bietet Ihnen eine konsistente API, egal ob Sie neue Dateien von Grund auf neu erstellen, vorhandene Excel-Arbeitsbücher laden oder Daten aus einer Datenbank exportieren. Sie verweisen auf Zellen mit der Standard-Excel-Notation (A1, B2) oder mit nullbasierten Zeilen- und Spaltennummern, je nach Arbeitsablauf.
Unterschiedliche Regionen und Systeme erfordern unterschiedliche Säulentrenner. In europäischen Ländern werden häufig Semikolons verwendet, da Kommas in Dezimalzahlen vorkommen. Tabulatorgetrennte Werte (TSV) sind in der Bioinformatik und bei der Verarbeitung von Protokolldateien üblich. Die SaveAsCsv-Methode von IronXL akzeptiert beliebige Zeichenfolgen als Trennzeichen:
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";
workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;
workSheet["A3"].Value = "North America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;
// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");
// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");Imports IronXL
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")
workSheet("A1").Value = "Region"
workSheet("B1").Value = "Revenue"
workSheet("C1").Value = "Units"
workSheet("A2").Value = "Europe"
workSheet("B2").Value = "1250000.50"
workSheet("C2").Value = 3400
workSheet("A3").Value = "North America"
workSheet("B3").Value = "2800000.00"
workSheet("C3").Value = 7200
' Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";")
' Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", vbTab)Die Trennzeichenkette wird ohne zusätzliche Parsing-Konfiguration direkt in das Trennzeichenfeld eingefügt. IronXL übernimmt das Setzen von Anführungszeichen für Zellen, die das Trennzeichen enthalten, und stellt so sicher, dass die Ausgabe RFC 4180 entspricht.
IronXL zeichnet sich durch die Konvertierung bestehender Excel-Dateien in CSV , die Auswertung von Formeln und die Wahrung der Datenintegrität aus. Dies ist unerlässlich bei der Arbeit mit Tabellenkalkulationen, die sowohl Kopfzeilen als auch dynamisch berechnete Werte enthalten.
using IronXL;
// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();
// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");Imports IronXL
' Load an Excel file with formulas and formatting
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")
' Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll()
' Export to CSV -- each worksheet creates a separate CSV file
' Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",")Beim Konvertieren von Arbeitsmappen mit mehreren Arbeitsblättern generiert IronXL automatisch einzelne CSV-Dateien für jedes Arbeitsblatt. Formelberechnungen werden vor dem Export ausgeführt, um genaue Daten im endgültigen CSV-Output zu gewährleisten. Die Methode EvaluateAll löst alle Formeln auf, einschließlich tabellenübergreifender Bezüge, bevor die Datei auf die Festplatte geschrieben wird.
Hier sehen Sie zunächst die aus der mehrseitigen Excel-Datei generierten CSV-Dateien:
Und dies ist ein Beispielvergleich eines der Excel-Blätter gegenüber der entsprechenden CSV-Datei:
Für datenbankgesteuerte Anwendungen macht IronXL DataTable-Exporte einfach. Das folgende Beispiel liest ein DataTable aus einer simulierten Datenquelle und schreibt es mit einem Semikolon als Trennzeichen in eine CSV-Datei:
using System.Data;
using IronXL;
// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}
// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
for (int col = 0; col < dataTable.Columns.Count; col++)
{
workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
}
row++;
}
// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");Imports System.Data
Imports IronXL
' Simulate a DataTable from a database query
Dim dataTable As DataTable = GetSalesData()
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")
' Write column headers from DataTable schema
For col As Integer = 0 To dataTable.Columns.Count - 1
workSheet.SetCellValue(0, col, dataTable.Columns(col).ColumnName)
Next
' Write data rows
Dim row As Integer = 1
For Each dataRow As DataRow In dataTable.Rows
For col As Integer = 0 To dataTable.Columns.Count - 1
workSheet.SetCellValue(row, col, If(dataRow(col)?.ToString(), String.Empty))
Next
row += 1
Next
' Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";")Beim Importieren aus einer DataTable wird jede Zeile in der dataTable.Rows-Sammlung zu einer neuen Zeile im Arbeitsblatt. IronXL bewahrt Datentypen während der Konvertierung — Zahlen bleiben numerisch, Datumsangaben behalten ihr Format und Text behandelt Sonderzeichen ohne zusätzliche Konfiguration.
Hier sehen Sie die simulierte Datenquelle neben der Ausgabedatei im CSV-Format:
Betrachten Sie dieses Szenario zum Export von Mitarbeiterdaten, das Arbeitsabläufe zum Schreiben von CSV-Dateien mit beiden Bibliotheken veranschaulicht.
CsvHelper-Implementierung:
using System.Globalization;
using System.IO;
using CsvHelper;
using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);Imports System.Globalization
Imports System.IO
Imports CsvHelper
Using writer As New StreamWriter("employees.csv")
Using csv As New CsvWriter(writer, CultureInfo.InvariantCulture)
csv.WriteRecords(employees)
End Using
End UsingIronXL-Implementierung:
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("employees");
int rowIndex = 1;
foreach (var emp in employees)
{
workSheet[$"A{rowIndex}"].Value = emp.Name;
workSheet[$"B{rowIndex}"].Value = emp.Salary;
workSheet[$"C{rowIndex}"].Value = emp.StartDate;
rowIndex++;
}
workBook.SaveAsCsv("employees.csv", ",");Imports IronXL
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("employees")
Dim rowIndex As Integer = 1
For Each emp In employees
workSheet($"A{rowIndex}").Value = emp.Name
workSheet($"B{rowIndex}").Value = emp.Salary
workSheet($"C{rowIndex}").Value = emp.StartDate
rowIndex += 1
Next
workBook.SaveAsCsv("employees.csv", ",")| Merkmal | CsvHelper | IronXL |
|---|---|---|
| Grundlegendes CSV-Schreiben | Ja | Ja |
| Excel zu CSV Konvertierung | Nein | Ja |
| Formel-Bewertung | Nein | Ja |
| Handhabung mehrerer Blätter | Nein | Ja |
| Erhaltung des Datentyps | Handbuch | Automatisch |
| Unterstützung für Excel-Formate (XLSX, XLS, XLSM) | Nein | Ja |
| Kein MS Office erforderlich | Ja | Ja |
| Zellformatierung und Stile | Nein | Ja |
| Plattformübergreifend (Unterstützung für .NET 10) | Ja | Ja |
CsvHelper übernimmt die einfache Serialisierung von POCO-Objekten effizient. IronXL bietet zusätzliche Fähigkeiten, wenn Sie bestehende Excel-Dateien laden, Formeln vor dem Export evaluieren oder Arbeitsblattbereiche mit feingranularer Kontrolle verwalten müssen. Wenn Ihr Arbeitsablauf den Empfang von .xlsx-Dateien von Geschäftsanwendern und deren Umwandlung in CSV für nachgelagerte Systeme umfasst, entfernt IronXL einen gesamten Konvertierungsschritt aus Ihrer Pipeline.
Die SaveAsCsv-Methode von IronXL wird mit mehreren produktionsbereiten Fähigkeiten geliefert:
| Merkmal | Beschreibung | Anwendungsfall |
|---|---|---|
| Benutzerdefinierte Trennzeichen | Komma, Semikolon, Tabulator oder ein beliebiges Zeichen | Regionale Gebietsschema-Kompatibilität |
| Kodierungsoptionen | UTF-8, UTF-16 und benutzerdefinierte Kodierungen | Internationale Zeichensätze |
| Formel-Bewertung | Berechnet Excel-Formeln vor dem Export | Finanzberichte, dynamische Daten |
| Plattformübergreifend | Windows, Linux, macOS | Cloud- und Container-Bereitstellungen |
| Export mehrerer Blätter | Eine CSV-Datei pro Arbeitsblatt | Komplexe Arbeitsbuchstrukturen |
| RFC 4180-Konformität | Automatische Anführungszeichen für Sonderzeichen | Garantierte Interoperabilität |
Sie können Zellendaten-Formatierungen vor dem Export anwenden, um zu steuern, wie Zahlen, Währungen und Daten in der CSV-Ausgabe erscheinen. Bei großen Datensätzen verarbeiten Sie Daten in Teilen mit Arbeitsblattbereichsoperationen, um einen vorhersehbaren Speicherverbrauch zu gewährleisten.
Die plattformübergreifende Unterstützung bedeutet, dass Sie die IronXL-basierte CSV-Generierung ohne Änderungen an Ihrem Code in Linux-Containern in Kubernetes oder Azure App Service bereitstellen können. Die Bibliothek enthält keine nicht verwalteten Abhängigkeiten und läuft daher auf allen Betriebssystemen identisch. Ausführliche Informationen zu den unterstützten Laufzeiten finden Sie im Kompatibilitätsleitfaden der IronXL-Plattform.
Bei der Verarbeitung großer Mengen von CSV-Exporten treten einige vorhersehbare Probleme auf. Hier erfahren Sie, wie Sie jedes einzelne Problem beheben können:
Sonderzeichen in Daten: IronXL maskiert automatisch Anführungszeichen, Kommas und Zeilenumbrüche innerhalb von Zellwerten. Sie müssen keine Zeichenketten vorverarbeiten oder benutzerdefinierte Escape-Logik schreiben – die Bibliothek verarbeitet die RFC 4180-Quoting-Regeln intern.
Große Datei-Verarbeitung: Für Arbeitsmappen mit Zehntausenden von Zeilen verwenden Sie Arbeitsblattbereiche, um Daten in Chargen zu verarbeiten. Durch das Schreiben von Zwischentabellen vor dem endgültigen Export haben Sie die Kontrolle über die Speicherbelegung.
Kodierungsprobleme: Geben Sie die UTF-8-Kodierung explizit an, wenn Sie internationale Zeichen, asiatische Schriftsysteme oder Emojis in Zellenwerten verwenden. IronXL unterstützt UTF-8- und UTF-16-Kodierung standardmäßig, sodass keine Kodierungsbibliothek von Drittanbietern erforderlich ist.
Fehlende oder falsch eingegebene Daten: IronXL behält standardmäßig numerische und Datumsformate bei. Wenn eine Zelle eine Formel enthält, die auf fehlende Daten verweist, wird EvaluateAll() in einen Fehlwert aufgelöst, anstatt stillschweigend einen leeren Text auszugeben, wodurch Datenqualitätsprobleme frühzeitig sichtbar werden.
Trennzeichen-Konflikte: Wenn Ihre Daten das Trennzeichen-Zeichen enthalten (zum Beispiel ein Preisfeld mit $1,200.00 bei Verwendung eines Kommas als Trennzeichen), umschließt IronXL den Wert automatisch gemäß den RFC 4180-Regeln mit doppelten Anführungszeichen.
Detaillierte Anleitungen finden Sie in der IronXL CSV-Dokumentation , der API-Referenz und den Supportressourcen .
Das Schreiben von CSV-Dateien ist nur die halbe Wahrheit. IronXL übernimmt auch das Lesen und Parsen von CSV-Dateien und lädt kommagetrennte Daten in eine Arbeitsmappenstruktur, die Sie abfragen, filtern und transformieren können, bevor Sie sie in ein beliebiges Format exportieren.
using IronXL;
// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
string product = row["A"].ToString();
int quantity = row["B"].IntValue;
decimal price = (decimal)row["C"].DoubleValue;
Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}
// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");Imports IronXL
' Load an existing CSV file into a workbook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Iterate over rows and process data
For Each row In workSheet.Rows
Dim product As String = row("A").ToString()
Dim quantity As Integer = row("B").IntValue
Dim price As Decimal = CType(row("C").DoubleValue, Decimal)
Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}")
Next
' Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",")Durch das Laden einer CSV-Datei über IronXL erhalten Sie Zugriff auf die vollständige Worksheet-API , einschließlich Sortierung , Filterung und Formelauswertung. Sie können die geladenen Daten auch als Excel-Datei speichern, indem Sie SaveAs verwenden. Dabei wird CSV in einem einzigen Methodenaufruf in XLSX konvertiert – eine häufige Anforderung beim Erstellen von Berichtgenerierungsdiensten.
Die Datenvalidierung vor dem Export verhindert Fehler in nachgelagerten Datenverarbeitungsketten. IronXL ermöglicht Ihnen den direkten Zugriff auf Zellwerte und -typen, sodass Sie vor dem Schreiben auf Nullwerte prüfen, numerische Bereiche erzwingen und fehlerhafte Datumsangaben ablehnen können:
using IronXL;
WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var errors = new List<string>();
for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
string productName = workSheet[$"A{rowIdx}"].StringValue;
double price = workSheet[$"C{rowIdx}"].DoubleValue;
if (string.IsNullOrWhiteSpace(productName))
errors.Add($"Row {rowIdx}: Product name is empty.");
if (price <= 0)
errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}
if (errors.Count == 0)
{
workBook.SaveAsCsv("validated_output.csv", ",");
Console.WriteLine("Export complete.");
}
else
{
foreach (var error in errors)
Console.WriteLine(error);
}Imports IronXL
Dim workBook As WorkBook = WorkBook.Load("input.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
Dim errors As New List(Of String)()
For rowIdx As Integer = 1 To workSheet.RowCount
Dim productName As String = workSheet($"A{rowIdx}").StringValue
Dim price As Double = workSheet($"C{rowIdx}").DoubleValue
If String.IsNullOrWhiteSpace(productName) Then
errors.Add($"Row {rowIdx}: Product name is empty.")
End If
If price <= 0 Then
errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).")
End If
Next
If errors.Count = 0 Then
workBook.SaveAsCsv("validated_output.csv", ",")
Console.WriteLine("Export complete.")
Else
For Each error As String In errors
Console.WriteLine(error)
Next
End IfDieses Muster ist besonders wertvoll in ETL-Pipelines, in denen fehlerhafte Zeilen zurückgewiesen und protokolliert werden sollten, anstatt stillschweigend exportiert zu werden. Die Zugriffsmethoden für Zellen-Daten an IronXL's RangeRow und Cell Objekten geben stark typisierte Werte zurück, wodurch das Risiko von stillen Typumwandlungsfehlern verringert wird.
IronXL wandelt das Schreiben von CSV-Dateien von einer Parsing-Herausforderung in eine direkte Operation um. Durch die Kombination von CSV-Funktionalität mit Excel-Arbeitsmappenunterstützung, Formelauswertung und automatischer Typbehandlung entfällt die Komplexität der Verwaltung mehrerer Bibliotheken oder manueller Datenkonvertierungen.
Die kostenlose Testversion bietet Ihnen vollen Zugriff auf alle Funktionen – einschließlich Export mehrerer Tabellenblätter, Formelauswertung und plattformübergreifender Bereitstellung – ohne dass während der Entwicklung ein Lizenzschlüssel erforderlich ist. Wenn Sie bereit sind, in die Produktion zu gehen, beginnt die Lizenzierung mit einer einzigen Entwicklerstufe, die die kommerzielle Nutzung abdeckt.
Wichtige Ressourcen für den Einstieg:
Bereit für die Erstellung produktionsreifer CSV-Workflows? Starten Sie Ihre kostenlose Testphase und exportieren Sie Ihre erste CSV-Datei in weniger als fünf Minuten.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.
IronXL ist ein Teil der IRONSUITE
10 .NET-API-Produkte für Ihre Bürodokumente
Das Excel-API, das Sie brauchen, ohne den Office Interop Aufwand.
