Ein Vergleich zwischen IronXL und CsvHelper

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 — Zellvisuelle Stile, Schrift, Größe, Hintergrundmuster, Rahmen, Ausrichtung und Zahlenformate.

CsvHelper Features

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

2.1. Verwendung 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.

class="content-img-align-center">

class="center-image-wrapper">

Verwalten des NuGet-Pakets auswählen

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

class="content-img-align-center">

class="center-image-wrapper">

Nach IronXL suchen

• 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
• Drücken Sie die Eingabetaste
• 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 die Datei Program.cs und klicken Sie dann auf Code anzeigen.
2. Fügen Sie die folgenden 'using'-Anweisungen oben in der Datei ein:

using IronXL;

using IronXL;

Imports IronXL

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

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
• Drücken Sie die Eingabetaste
• 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.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")

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")

Jedes 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, indem Sie sie nach Namen abrufen:

// 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")

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

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

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 einfach die Excel-Datei im CSV-Format, indem die Methode SaveAsCsv 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"

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

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

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 = "<path to our CSV file>"

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

' Read CSV file
Using fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read)
	Using textReader = New StreamReader(fs, Encoding.UTF8)
	Using csv = 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 person
	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 Spalte FirstName auf Person.FirstName abgebildet. Dann können wir data durchlaufen und die Werte in jeder Zeile abrufen.

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 ein True/False haben kann und nicht standardisierte Werte enthält. Es kann durch Erstellen eines benutzerdefinierten Konverters 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

Auch wenn bool ein standardmäßiger .NET-Typ ist, kann der Standardkonverter nur True/False-Werte verarbeiten, während unsere CSV-Datei Yes/No hat. Hier müssen wir die DefaultTypeConverter unterklassen, dann die Methode ConvertFromString überschreiben.

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 existierenden CSV-Datei hinzufügen, da es einfach vorherige Einträge überschreibt.