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

Warum ist die Konvertierung von CSV in DataTable wichtig?

Mit der Konvertierung von CSV in DataTable können Entwickler kommagetrennte Werte in strukturierte Objekte für die weitere Verarbeitung umwandeln. Unabhängig davon, ob Sie Bestandsdaten, Kundendatensätze oder Transaktionsprotokolle verarbeiten, ist die effiziente Konvertierung von CSV in DataTable von entscheidender Bedeutung. Durch die Verwendung der ersten Zeile als Spaltenüberschriften können Sie sicherstellen, dass die DataTable-Spalten mit dem Schema Ihrer Datenbanktabelle übereinstimmen, was sie perfekt für Excel zu DataSet Operationen macht.

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 Paketmanager-Konsole in Visual Studio und führen Sie 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;

Imports IronXL
Imports 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 konvertiert man eine CSV-Datei in DataTable?

Der Kern-Workflow in IronXL umfasst nur wenige Codezeilen. Im Folgenden wird beschrieben, wie man eine CSV-Datei liest und sie mit Hilfe von Top-Level-Anweisungen in C# 10+ in eine DataTable-Datei konvertiert:

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();
}

Imports IronXL
Imports System.Data

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

' Access the default worksheet
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Convert to DataTable with headers
Dim dataTable As DataTable = worksheet.ToDataTable(True)

' Display the data
For Each row As DataRow In dataTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

Die LoadCSV-Methode parst Ihre CSV-Datei automatisch und behandelt dabei Felder mit Anführungszeichen und eingebetteten Kommas. Der Parameter fileFormat teilt IronXL mit, wie die CSV-Daten intern zu interpretieren sind, um sicherzustellen, dass sie als Excel-kompatible Struktur behandelt werden. Nach dem Laden konvertiert die Methode ToDataTable(true) das Arbeitsblatt in ein DataTable, wobei der Parameter true angibt, dass die erste Zeile als Spaltenüberschrift verwendet werden soll. Das Ergebnis ist eine saubere, strukturierte DataTable mit benannten Spalten, die Ihren CSV-Kopfzeilen 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, können Sie ihn mit SqlBulkCopy effizient in SQL Server importieren. 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");

Imports System.Data
Imports Microsoft.Data.SqlClient
Imports IronXL

' Create connection string
Dim connectionString As String = "Data Source=localhost;Initial Catalog=SalesDB;" &
    "Integrated Security=True;TrustServerCertificate=True;"

' Read CSV into DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("inventory_report.csv")
Dim dataTable As DataTable = workbook.DefaultWorkSheet.ToDataTable(True)

' Bulk insert into SQL Server
Using connection As New SqlConnection(connectionString)
    connection.Open()

    Using bulkCopy As 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)
    End Using
End Using

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

Die Klasse SqlBulkCopy bietet eine hohe Leistung für umfangreiche Datenimporte. Die ColumnMappings-Sammlung bildet DataTable-Spalten auf Datenbankspalten mit unterschiedlichen Namen ab und gewährleistet so Flexibilität in Ihrem Datenschema. Die Eigenschaft BatchSize optimiert die Speichernutzung, indem sie Datensätze in Stücken verarbeitet, 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 verwenden, um Daten vor dem Import vorab zu validieren.

Wie geht man mit unterschiedlichen CSV-Trennzeichen um?

Nicht alle CSV-Dateien verwenden Kommas. IronXL verarbeitet verschiedene Trennzeichen und ist daher sowohl für internationale Datenformate als auch für ältere Systeme geeignet:

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();
}

Imports IronXL
Imports System
Imports System.Data
Imports System.IO

' --- Tab-delimited file ---
Dim tsvPath As String = "export_data.tsv"
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, ControlChars.Tab)

' --- Semicolon-delimited file ---
Dim semiPath As String = "european_data.csv"
Dim tempCsv As String = Path.Combine(Path.GetTempPath(), "european_data_comma.csv")

' Replace semicolons with commas for proper parsing
Dim lines As String() = File.ReadAllLines(semiPath)
For i As Integer = 0 To lines.Length - 1
    lines(i) = lines(i).Replace(";"c, ","c)
Next
File.WriteAllLines(tempCsv, lines)

Dim semiWorkbook As WorkBook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX)

' Print tab-delimited results
Dim tsvTable As DataTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine("--- Tab-delimited File ---")
For Each col As DataColumn In tsvTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In tsvTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

' Print semicolon-delimited results
Dim semiTable As DataTable = semiWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine(vbCrLf & "--- Semicolon-delimited File ---")
For Each col As DataColumn In semiTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In semiTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

Dieser Code demonstriert das Laden von CSV-Dateien mit verschiedenen 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. Bei komplexeren Dateiformaten können Sie auch den Export von Excel-Daten in verschiedene Formate in Betracht ziehen.

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 aus beliebigen Dateipfaden mithilfe der LoadCSV-Funktion
• Konvertieren von CSV-Daten in ein DataTable mit korrekter Datenformatierung
• Beibehaltung von Spaltenüberschriften und DataTable-Spalten durch automatisches Parsing
• Importieren Sie Millionen von Zeilen mithilfe von Massenoperationen effizient in eine Datenbanktabelle

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. Ganz gleich, ob Sie ASP.NET-Anwendungen erstellen, mit Blazor arbeiten oder .NET 10-Desktop-Apps entwickeln – IronXL bietet konsistente, zuverlässige CSV-Verarbeitung auf allen Plattformen.

Bereit zum Start? Die IronXL-Dokumentation behandelt jede Funktion ausführlich, und mit einer Testlizenz können Sie die gesamte IronXL-Bibliothek evaluieren.