Das Arbeiten mit CSV-Dateien kann eine anspruchsvolle Aufgabe sein. Es gibt heute viele Bibliotheken, die Entwicklern bei dieser Aufgabe helfen, ohne dass Microsoft Excel installiert sein muss.

In diesem Artikel werden wir besprechen und vergleichen, wie man programmgesteuert mit Microsoft Excel-Dokumenten in C# .NET-Technologien arbeiten kann, entweder im CSV-Format oder im Standard-XLSX-Format, unter Verwendung von zwei der beliebtesten Bibliotheken, IronXL und CsvHelper.

Schauen wir uns zunächst an, was beide Bibliotheken zu bieten haben.

Die IronXL-Bibliothek

IronXL ist eine .NET-Bibliothek, die das Lesen und Bearbeiten von Microsoft Excel-Dokumenten mit C# erleichtert. IronXL.Excel ist eine eigenständige .NET-Softwarebibliothek zum Lesen einer Vielzahl von Tabellenformaten. Es erfordert nicht, dass Microsoft Excel installiert ist, noch hängt es von Interop ab. Es funktioniert sehr reibungslos mit CSV-Dateien.

IronXL ist eine intuitive C#-API, die es ermöglicht, Excel-Tabellenkalkulationsdateien in .NET mit blitzschneller Leistung zu lesen, zu bearbeiten und zu erstellen. IronXL unterstützt vollständig .NET Core, .NET Framework, Xamarin, Mobile, Linux, macOS und Azure.

IronXL ist eine führende .NET Core- und .NET Framework-Excel-Tabellenbibliothek für C#.

IronXL-Feature-Set

• Laden, lesen und bearbeiten von Daten — aus XLS/XLSX/CSV/TSV
• Speichern und Exportieren — nach XLS/XLSX/CSV/TSV/JSON
• Bereiche — einfach zu verwendende WorkSheet["A1:B10"]-Syntax. Kombinieren und Erstellen von Bereichen intuitiv.
• Sortieren — Bereiche, Spalten und Zeilen sortieren.
• Styling — Zellen-Visualstile, Schriftart, Größe, Hintergrundmuster, Rahmen, Ausrichtung und Zahlenformate.

CsvHelper

Eine .NET-Bibliothek zum Lesen und Schreiben von CSV-Dateien. Extrem schnell, flexibel und einfach zu bedienen. Unterstützt das Lesen und Schreiben von benutzerdefinierten Klassenobjekten. Alle Beispielcodes sind in der CsvHelper-Dokumentation verfügbar.

CsvHelper Features

• Schnell: kompiliert Klassen im laufenden Betrieb für extrem schnelle Leistung
• Flexibel: konservativ beim Schreiben, liberal beim Lesen
• Einfach zu verwenden: Lesen und Schreiben sind so einfach wie GetRecords<t>() und WriteRecords(records)
• Hoch konfigurierbar
• Linux-Modus
• Geringer Speicherverbrauch

1. Erstellen Sie eine Konsolenanwendung

Verwenden Sie die folgenden Schritte, um eine Konsolenanwendung zu erstellen:

• Starten Sie die Visual Studio 2022 IDE.
• Klicken Sie auf "Neues Projekt erstellen".
• Wählen Sie auf der Seite "Neues Projekt erstellen" C# in der Sprachliste, Windows aus der Plattformen Liste und Konsole aus der "Projekttypen" Liste.
• Wählen Sie aus den angezeigten Projektvorlagen Konsolen-App (.NET Framework).

Projekt erstellen - Konsolenanwendung

• Klicken Sie auf Weiter.
• Geben Sie auf dem Bildschirm Zusätzliche Informationen die Framework-Version an, die Sie verwenden möchten. In diesem Beispiel verwenden wir .NET Framework 4.8.

Projekt erstellen - .NET Framework

• Klicken Sie auf Erstellen, um den Vorgang abzuschließen.

Das Projekt ist jetzt erstellt und wir sind fast bereit, die Bibliotheken zu testen. Wir müssen sie jedoch noch in unser Projekt installieren und integrieren. Lassen Sie uns zunächst IronXL installieren.

2. IronXL C# Bibliothekeninstallation

Sie können die IronXL-Bibliothek mit den folgenden Methoden herunterladen und installieren:

1. Verwendung von Visual Studio mit NuGet-Paketen
2. Herunterladen des NuGet-Pakets direkt
3. Manuelle Installation mit der DLL

Schauen wir uns jede genauer an.

2.1. Verwenden von Visual Studio mit NuGet-Paketen

Visual Studio bietet den NuGet-Paket-Manager, um NuGet-Pakete in Ihren Projekten zu installieren. Sie können darauf über das Projektmenü oder durch Rechtsklick auf Ihr Projekt im Solution Explorer zugreifen.

Select-Manage-NuGet-Paket

• Suchen Sie jetzt über den Such-Tab -> nach IronXL.Excel -> Installieren

Suchen Sie nach IronXL

• Und wir sind fertig.

2.2. Direktes Herunterladen des NuGet-Pakets

Dies kann durch direkten Besuch der NuGet-Seite und Herunterladen des Pakets erfolgen. Die Schritte sind:

• Gehen Sie zu https://www.nuget.org/packages/IronXL.Excel
• Wählen Sie "Paket herunterladen"
• Doppelklicken Sie auf das heruntergeladene Paket
• Das Paket wird installiert
• Laden Sie Ihr Visual Studio-Projekt neu und beginnen Sie es zu verwenden

2.3. Manuelle Installation mit der DLL

Eine andere Möglichkeit, die IronXL C#-Bibliothek herunterzuladen und zu installieren, besteht darin, die folgenden Schritte zu verwenden, um das IronXL NuGet-Paket über die Entwickler-Eingabeaufforderung zu installieren.

• Öffnen Sie die Entwickler-Eingabeaufforderung — normalerweise im Visual Studio-Ordner zu finden.
• Geben Sie den folgenden Befehl ein: PM> Install-Package IronXL.Excel
• Eingabetaste drücken
• Dadurch wird das Paket heruntergeladen und installiert
• Laden Sie Ihr Visual Studio-Projekt neu und beginnen Sie es zu verwenden

2.4. Notwendige 'using'-Anweisungen hinzufügen

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Program.cs und wählen Sie Code anzeigen.
2. Fügen Sie die folgenden 'using'-Anweisungen oben in der Datei ein:

using IronXL;

using IronXL;

Imports IronXL

Imports IronXL

Fertig! IronXL ist heruntergeladen, installiert und einsatzbereit. Wir sollten jedoch vorher CsvHelper installieren.

3. CsvHelper-Installation

3.1. Verwendung der NuGet-Paketmanager-Konsole

Um die CsvHelper C#-Bibliothek herunterzuladen und zu installieren, verwenden Sie die folgenden Schritte, um das NuGet-Paket über die Entwickler-Eingabeaufforderung zu installieren.

• Öffnen Sie die Entwickler-Eingabeaufforderung — normalerweise im Visual Studio-Ordner zu finden.
• Geben Sie den folgenden Befehl ein: PM> Install-Package CsvHelper -Version 27.2.1
• Eingabetaste drücken
• Dadurch wird das Paket heruntergeladen und installiert
• Laden Sie Ihr Visual Studio-Projekt neu und beginnen Sie es zu verwenden

3.2. Direkter Download

Von der NuGet-Website herunterladen: https://www.nuget.org/packages/CsvHelper.

4. Arbeiten mit CSV-Dateien unter Verwendung von IronXL

Eine durch Kommas getrennte Werte (CSV)-Datei ist eine Textdatei mit Trennzeichen, die ein Komma verwendet, um Werte zu trennen. Jede Zeile der Datei ist ein Datensatz. Um diese Dateien für Berechnungen zu manipulieren, kann eine herausfordernde Aufgabe sein, und IronXL bietet eine ziemlich gute und einfache Option, dies ohne Microsoft Excel zu tun. Lassen Sie uns zuerst eine CSV-Datei in eine normale Excel-Datei konvertieren.

4.1. Konvertieren einer CSV-Datei in Excel-Format

Der Prozess ist ziemlich einfach und unkompliziert. Es wird in der Regel mit einer einzigen Codezeile erledigt.

CSV in Excel-Formate:

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

' Load the CSV file and convert it to an Excel format
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Access the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet

' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")

' Load the CSV file and convert it to an Excel format
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Access the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet

' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")

4.2. Lesen und Manipulieren konvertierter CSV-Dateien unter Verwendung von IronXL

Die IronXL WorkBook-Klasse repräsentiert ein Excel-Blatt. Um eine Excel-Datei mit C# zu öffnen, verwenden wir WorkBook.Load und geben den Pfad der Excel-Datei (.xlsx) an. Der folgende Einzeiler wird verwendet, um die Datei zum Lesen zu öffnen:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets/sample.xlsx")

' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets/sample.xlsx")

Jeder WorkBook kann mehrere WorkSheet-Objekte enthalten. Diese stellen Arbeitsblätter im Excel-Dokument dar. Wenn die Arbeitsmappe Arbeitsblätter enthält, greifen Sie wie folgt auf sie zu:

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

' Open the sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")

' Open the sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")

Code zum Lesen der Zellwerte:

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

' Read from ranges of cells elegantly
For Each cell In worksheet("A2:A10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell

' Read from ranges of cells elegantly
For Each cell In worksheet("A2:A10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell

Nach dem Laden und Lesen der Arbeitsmappe und des Arbeitsblatts kann der folgende Code verwendet werden, um entweder Änderungen an Formeln zu machen oder sie auf bestimmte Zellen anzuwenden. Der Code sieht wie folgt aus:

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

' Set formulas in specific cells
worksheet("A1").Formula = "SUM(B8:C12)"
worksheet("B8").Formula = "=C9/C11"
worksheet("G30").Formula = "MAX(C3:C7)"

' Force recalculate all formula values in all sheets
workbook.EvaluateAll()

' Set formulas in specific cells
worksheet("A1").Formula = "SUM(B8:C12)"
worksheet("B8").Formula = "=C9/C11"
worksheet("G30").Formula = "MAX(C3:C7)"

' Force recalculate all formula values in all sheets
workbook.EvaluateAll()

4.3. Speichern des Excel-Dokuments zurück in CSV-Datei

Das Schreiben von CSV-Dateien ist ein einfacher Prozess mit IronXL. Der folgende Code speichert die Excel-Datei einfach im CSV-Format, indem die SaveAsCsv-Methode verwendet wird.

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

' Load the Excel Workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")

' Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' This will save as "SaveAsCSV.Sheet1.csv"

' Load the Excel Workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")

' Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' This will save as "SaveAsCSV.Sheet1.csv"

5. Arbeiten mit CSV-Dateien unter Verwendung von CsvHelper

Das Lesen von CSV-Dateien ist eine dieser Aufgaben, die viel einfacher scheint, als sie tatsächlich sind. Die CsvHelper-Bibliothek macht es einfach, Code zu schreiben, der typsicher, schnell und flexibel ist.

5.1. Lesen von CSV-Dateien mit CsvHelper

Dies ist die Beispiel-CSV-Datei, sie hat drei Textspalten und eine Nummernspalte.

FirstName,LastName,Age,IsActive
Ali,Talal,30,Yes
Affan,Ahmad,31,No
Saad,Bhatti,31,Yes

FirstName,LastName,Age,IsActive
Ali,Talal,30,Yes
Affan,Ahmad,31,No
Saad,Bhatti,31,Yes

Wir werden jede Zeile in ein Objekt vom Typ Person abbilden.

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

' Define the Person class to map CSV records
Public Class Person
	Public Property FirstName() As String
	Public Property LastName() As String
	Public Property Age() As Integer?
	Public Property IsActive() As String
End Class

' Define the Person class to map CSV records
Public Class Person
	Public Property FirstName() As String
	Public Property LastName() As String
	Public Property Age() As Integer?
	Public Property IsActive() As String
End Class

Der Code zum Lesen unserer CSV-Datei ist unten.

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();
        
        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();
        
        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

' Define the path to the CSV file
Dim fileName As String = "<path to our CSV file>"

' Configure CsvHelper
Dim configuration As New CsvConfiguration(CultureInfo.InvariantCulture) With {
    .Encoding = Encoding.UTF8,
    .Delimiter = ","
}

' Read CSV file
Using fs As FileStream = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read)
    Using textReader As New StreamReader(fs, Encoding.UTF8)
        Using csv As New CsvReader(textReader, configuration)
            Dim data = csv.GetRecords(Of Person)()
            
            ' Iterate over each person record
            For Each person In data
                ' Process each Person object
            Next
        End Using
    End Using
End Using

' Define the path to the CSV file
Dim fileName As String = "<path to our CSV file>"

' Configure CsvHelper
Dim configuration As New CsvConfiguration(CultureInfo.InvariantCulture) With {
    .Encoding = Encoding.UTF8,
    .Delimiter = ","
}

' Read CSV file
Using fs As FileStream = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read)
    Using textReader As New StreamReader(fs, Encoding.UTF8)
        Using csv As New CsvReader(textReader, configuration)
            Dim data = csv.GetRecords(Of Person)()
            
            ' Iterate over each person record
            For Each person In data
                ' Process each Person object
            Next
        End Using
    End Using
End Using

Der Typ von data ist IEnumerable<Person>. CsvHelper wird automatisch jede Spalte der Eigenschaft mit demselben Namen zuordnen. Zum Beispiel wird der Wert in der FirstName-Spalte in Person.FirstName abgebildet. Wir können dann data durchlaufen und auf die Werte in jeder Zeile zugreifen.

5.2. Konvertieren von Daten in CSV-Dateien von einem Typ in einen anderen

CSV-Dateien enthalten meistens Textdaten. Zum Beispiel ist die Alters-Spalte ein Integer-Wert und die CSV-Datei enthält nur Text. CsvHelper kann Daten von Zeichenketten in standardmäßige .NET-Typen (Boolean, Int32, Int64, Enum) konvertieren. In unserem Fall haben wir einen IsActive-Bool-Datentyp, der nur einen True/False haben kann und nicht standardmäßige Werte enthält. Es kann durch einen benutzerdefinierten Konverter konvertiert werden. Das Code-Styling sieht wie folgt aus:

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

' Custom Boolean Converter for CsvHelper
Public Class CustomBooleanConverter
	Inherits DefaultTypeConverter

	Public Overrides Function ConvertFromString(ByVal text As String, ByVal row As IReaderRow, ByVal memberMapData As MemberMapData) As Object
		' Convert "Yes" to true and anything else to false
		Return text.Equals("Yes", StringComparison.OrdinalIgnoreCase)
	End Function
End Class

' Custom Boolean Converter for CsvHelper
Public Class CustomBooleanConverter
	Inherits DefaultTypeConverter

	Public Overrides Function ConvertFromString(ByVal text As String, ByVal row As IReaderRow, ByVal memberMapData As MemberMapData) As Object
		' Convert "Yes" to true and anything else to false
		Return text.Equals("Yes", StringComparison.OrdinalIgnoreCase)
	End Function
End Class

Obwohl bool ein standardmäßiger .NET-Typ ist, kann der Standardkonverter nur den True/False-Wert verarbeiten, während unsere CSV-Datei Yes/No enthält. Hier müssen wir die DefaultTypeConverter unterklassen und dann die ConvertFromString-Methode überschreiben.

6. Lizenzierung

IronXL ist eine offen kommerzielle C# Excel-Bibliothek. Es ist kostenlos für die Entwicklung und kann jederzeit für den kommerziellen Einsatz lizenziert werden. Lizenzen sind verfügbar für Einzelprojektgebrauch, Einzelentwickler, Agenturen und globale Unternehmen, sowie für SaaS und OEM-Weiterverteilung. Alle Lizenzen umfassen eine 30-Tage-Geld-zurück-Garantie, ein Jahr Produktsupport und -aktualisierungen, Gültigkeit für Entwicklung, Test- und Produktionsumgebungen und auch eine Dauerlizenz (einmaliger Kauf). Das Lite-Paket beginnt ab $999.

CsvHelper — das Lesen und Schreiben von CSV-Dateien ist vollständig kostenlos für den kommerziellen Gebrauch.

7. Zusammenfassung und Schlussfolgerung

Zusammenfassung

IronXL ist eine umfassende Bibliothek, die Ihnen alles bietet, was Sie brauchen, um eine Excel-Datei zu manipulieren. Es ist einfach zu verwenden und bietet Ihnen die Möglichkeit, verschiedene Formate in XLSX und von XLSX in andere Formate, wie CSV, zu konvertieren. Diese Interkonversion bietet dem Benutzer Flexibilität, um mit verschiedenen Dateiformaten einfach umzugehen.

Auf der anderen Seite ist CsvHelper speziell dafür entwickelt, mit CSV-Dateiformaten zu arbeiten, was bedeutet, dass es nur mit CSV-Dateien umgehen kann. Alle Beispielcodes finden Sie in den CsvHelper-Dokumentationsdateien. Die Dokumentation gibt Ihnen Richtlinien, wie Sie CsvHelper in Ihrem Projekt verwenden.

Abschluss

IronXL hat einen deutlichen Vorteil gegenüber CsvHelper, da es Benutzer unterstützt, die mit mehreren Formaten arbeiten. Darüber hinaus können Sie Formeln und Stile nach Ihrem Wunsch anwenden, während CsvHelper nur das Lesen und Schreiben von CSV-Dateien mit begrenzten Optionen erlaubt. Außerdem können Sie keine neuen Datensätze zu einer bereits vorhandenen CSV-Datei hinzufügen, da sie einfach frühere Einträge überschreibt.