Wie man eine CSV-Datei in C# in eine DataTable liest

Warum ist die Konvertierung von CSV zu DataTable wichtig?

Die Konvertierung von CSV in DataTable ermöglicht es Entwicklern, durch Kommas getrennte Werte in strukturierte Objekte zur Weiterverarbeitung umzuwandeln. Egal ob Sie Bestandsdaten, Kundendatensätze oder Transaktionsprotokolle verarbeiten, die effiziente Konvertierung von CSV in das DataTable Format ist von entscheidender Bedeutung. Wenn Sie die erste Zeile als Spaltenüberschriften verwenden, können Sie sicherstellen, dass die DataTable-Spalten mit Ihrem Datenbanktabellenschema übereinstimmen, wodurch sie sich perfekt für Excel-zu-SQL-Operationen eignen.

Traditionelle Ansätze kämpfen oft mit großen Dateien, unterschiedlichen Trennzeichen oder Speicherverwaltung. IronXL beseitigt diese Herausforderungen und verarbeitet verschiedene Trennzeichen, Felder in Anführungszeichen und eingebettete Kommas ohne zusätzlichen Code. Die CSV-Lesefunktionen von IronXL beseitigen häufige Probleme und bieten zusätzliche Funktionen wie Datenvalidierung und Dateigrößenkontrolle.

Wie installiert man IronXL?

Für den Einstieg in IronXL ist lediglich die Installation eines einfachen NuGet Pakets erforderlich. Öffnen Sie die NuGet Paket-Manager-Konsole in Visual Studio und führen Sie einen der folgenden Befehle aus:

Install-Package IronXL

Install-Package IronXL

Oder falls Sie die .NET Befehlszeilenschnittstelle bevorzugen:

dotnet add package IronXL

dotnet add package IronXL

Nach der Installation fügen Sie das IronXL-Namespace zu Ihrem Projekt hinzu:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Dies ermöglicht den Zugriff auf alle CSV-Verarbeitungsfunktionen ohne Abhängigkeit von Excel. Weitere Details finden Sie in der IronXL Dokumentation und im NuGet Installationsleitfaden .

Wie lässt sich überprüfen, ob die Installation erfolgreich war?

Erstellen Sie ein Testprogramm, das eine CSV-Datei lädt, um die Installation zu überprüfen. Sollten Lizenzierungsmeldungen erscheinen, benötigen Sie einen Lizenzschlüssel . Überprüfen Sie die Paketverweise in Ihrer Projektdatei, um sicherzustellen, dass IronXL in der richtigen Version angezeigt wird. Führen Sie einen einfachen CSV-Lesevorgang durch – wenn dieser fehlerfrei abgeschlossen wird, funktioniert Ihre Installation ordnungsgemäß.

Mit NuGet installieren

PM >  Install-Package IronXL.Excel

Schauen Sie sich IronXL auf NuGet für eine schnelle Installation an. Mit über 10 Millionen Downloads transformiert es die PDF-Entwicklung mit C#. Sie können auch das DLL herunterladen.

Wie konvertiert man eine CSV-Datei in das Format DataTable?

Der Kern-Workflow in IronXL umfasst nur wenige Codezeilen. Hier erfahren Sie, wie Sie in C# 10+ eine CSV-Datei lesen und sie mithilfe von Top-Level-Anweisungen in das Format DataTable konvertieren:

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

Die Methode LoadCSV analysiert Ihre CSV-Datei automatisch und verarbeitet dabei Felder in Anführungszeichen und eingebettete Kommas. Der Parameter fileFormat teilt IronXL mit, wie die CSV-Daten intern interpretiert werden sollen, und stellt sicher, dass sie als Excel-kompatible Struktur behandelt werden. Nach dem Laden wandelt die Methode ToDataTable(true) das Arbeitsblatt in ein DataTable um, wobei der Parameter true angibt, dass die erste Zeile als Spaltenüberschriften verwendet werden soll. Das Ergebnis ist eine saubere, strukturierte DataTable-Datei mit benannten Spalten, die Ihren CSV-Überschriften entsprechen. Weitere fortgeschrittene Manipulationsmöglichkeiten finden Sie im vollständigen IronXL -Leitfaden .

Der Konvertierungsprozess erhält außerdem die Datentypen – Zahlen bleiben numerisch, Datumsangaben werden korrekt interpretiert und Textfelder behalten ihre Formatierung. Diese automatische Typinferenz spart im Vergleich zu manuellen Parsing-Ansätzen erhebliche Entwicklungszeit. Für Szenarien, die eine benutzerdefinierte Datenformatierung erfordern, können Sie die Zellenformatierung vor der Konvertierung anwenden.

Wie importiert man einen DataTable in SQL Server?

Sobald Sie Ihren DataTable haben, wird der Import in SQL Server mit SqlBulkCopy effizient. Das folgende Beispiel verwendet C#-Anweisungen auf oberster Ebene:

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

Die Klasse SqlBulkCopy bietet eine hohe Leistungsfähigkeit für den Import großer Datenmengen. Die Sammlung ColumnMappings ordnet DataTable Spalten Datenbankspalten mit anderen Namen zu und gewährleistet so Flexibilität in Ihrem Datenschema. Die Eigenschaft BatchSize optimiert die Speichernutzung, indem Datensätze in Blöcken verarbeitet werden, anstatt alles auf einmal zu laden. Erfahren Sie mehr über die Import- und Exportfunktionen von IronXL .

Um die Datenintegrität weiter zu verbessern, sollten Sie die Implementierung von Transaktionsunterstützung für Ihre Massenkopiervorgänge in Betracht ziehen. Dadurch wird sichergestellt, dass Teilimporte im Fehlerfall rückgängig gemacht werden können. Sie können auch die Funktionen von IronXL zum Schreiben von Excel-Dateien nutzen, um Daten vor dem Import vorab zu validieren.

Hier können Sie mit der Abfrage SELECT * FROM dbo.Inventory; in SSMS überprüfen, ob Ihre CSV-Daten in den SQL Server importiert wurden. Schauen Sie sich zunächst die Daten in der Beispiel-CSV-Datei an:

Wenn Sie sich nun die Ausgabe der Abfrage ansehen, können Sie erkennen, dass jede Spalte, jede Überschrift und jede Zeile erfolgreich in die Datenbanktabelle kopiert wurde.

Wie geht man mit unterschiedlichen CSV-Trennzeichen um?

Nicht alle CSV-Dateien verwenden Kommas. IronXL verarbeitet verschiedene Trennzeichen und eignet sich daher sowohl für internationale Datenformate als auch für ältere Systeme. Das folgende Beispiel veranschaulicht das Laden von tabulatorgetrennten und semikolongetrennten Dateien:

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

Dieser Code demonstriert das Laden von CSV-Dateien mit unterschiedlichen Trennzeichen in IronXL WorkBook Objekte. Tabulatorgetrennte Dateien werden mit "\t" als Trennzeichen gelesen, während semikolongetrennte Dateien vor dem Laden in das Standard-CSV-Format konvertiert werden. Das Standardarbeitsblatt jeder Arbeitsmappe wird in ein DataTable mit ToDataTable(true) konvertiert, wobei die erste Zeile als Spaltenüberschriften verwendet wird. Bei komplexeren Dateiformaten können Sie auch den Export von Excel-Daten in verschiedene Formate in Betracht ziehen.

Die Flexibilität im Umgang mit verschiedenen Trennzeichen löst viele reale Herausforderungen beim Parsen von CSV-Dateien. Bei der Arbeit mit europäischen Datenformaten berücksichtigt IronXL durch seine Trennzeichenbehandlung regionale Unterschiede in den Datenformatierungsstandards. Bei Dateien mit inkonsistenten Strukturen muss der Rohtext vor der Übergabe an LoadCSV vorverarbeitet werden.

Der RFC 4180-Standard definiert die CSV-Formatspezifikation, die IronXL für Felder in Anführungszeichen und eingebettete Kommas befolgt. Diese Flexibilität wird auch ausführlich im Stack Overflow Community-Thread zum Thema "CSV in DataTable in .NET einlesen" diskutiert.

Welche IronXL -Funktionen werden neben CSV unterstützt?

IronXL bietet weit mehr als nur das Lesen von CSV-Dateien. Die Bibliothek deckt das gesamte Spektrum der Excel- und Tabellenkalkulationsoperationen in C# ab und ist somit eine einzige Abhängigkeit für datenzentrierte Anwendungen.

Was sind die nächsten Schritte?

IronXL macht den Import von CSV-Datenbanken zu einem unkomplizierten und zuverlässigen Prozess. Mit nur wenigen Zeilen Code können Sie:

• Lesen Sie CSV-Dateien von beliebigen Dateipfaden mithilfe der LoadCSV-Funktionalität.
• Konvertieren Sie CSV-Daten in ein DataTable-Format mit korrekter Datenformatierung
• Spaltenüberschriften und DataTable-Spalten durch automatische Analyse beibehalten
• Importieren Sie Millionen von Zeilen effizient in eine Datenbanktabelle mithilfe von Massenoperationen

Die Bibliothek kümmert sich um die Feinheiten des CSV-Parsings, der Speicherverwaltung und der Datentypkonvertierungen, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können, anstatt sich mit Details der Dateiverarbeitung auseinandersetzen zu müssen. Egal ob Sie ASP.NET Anwendungen erstellen, mit Blazor arbeiten oder .NET 10-Desktop-Apps entwickeln, IronXL bietet eine konsistente und zuverlässige CSV-Verarbeitung auf allen Plattformen.

Bereit zum Start? Die IronXL Dokumentation beschreibt alle Funktionen ausführlich, und mit einer Testlizenz können Sie die gesamte Bibliothek testen. Mit umfangreichen Codebeispielen und klaren API-Referenzen werden Sie im Handumdrehen CSV-Dateien in Ihren .NET 10-Anwendungen effizient verarbeiten können.