Ein Vergleich zwischen IronXL und CsvWriter

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.

CsvWriter-Funktionen

• 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:

• Navigate tohttps://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 nutzen, um das IronXL NuGet-Paket über die Entwickler-Befehlszeile zu installieren.

• Öffnen Sie das Entwickler-Befehlsfenster — normalerweise im Visual Studio-Ordner zu finden.
• Geben Sie den folgenden Befehl ein:

  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 Lösungsexplorer mit der rechten Maustaste auf die Datei Program.cs und wählen Sie dann Code anzeigen.
2. Fügen Sie am Anfang der Code-Datei die folgenden using-Direktiven hinzu:

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 mit CSVWriter zu arbeiten, müssen Sie die CsvHelper C#-Bibliothek herunterladen und installieren. Gehen Sie dazu die folgenden Schritte durch, um das NuGet-Paket über das Entwickler-Befehlsfenster zu installieren.

• Öffnen Sie das Entwickler-Befehlsfenster — normalerweise im Visual Studio-Ordner zu finden.
• Geben Sie den folgenden Befehl ein:

  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
• Überprüfen Sie die CsvHelper.CsvWriter-Methode im Detail für die Implementierung.

3.2. Direkter Download

Download from the NuGet website: 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 specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

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

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

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

' Load the CSV file and specify the format and delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Get 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 Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

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

' Open 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 des Arbeits- und Arbeitsblattes kann das folgende Codebeispiel verwendet werden, um entweder Änderungen an Formeln vorzunehmen oder Formeln auf bestimmte Zellen anzuwenden. Der Code sieht wie folgt aus:

// Set Formulas
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
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
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 workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

' Load the workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' Saved as : SaveAsCSV.Sheet1.csv

5.1. Erstellen einer einfachen Konsolenanwendung

Erstellen Sie eine einfache CSVWriter-Konsole mit bereitgestelltem Trennzeichen unter Verwendung von Visual Studio. Sobald das Projekt erstellt ist, besteht der nächste Schritt darin, eine Person-Klasse zu erstellen:

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

Public Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property IsLiving() As Boolean
End Class

Innerhalb der Main-Methode erstellen wir nun eine Liste von Person-Objekten, die wir in die CSV-Datei schreiben werden:

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

Dim myPersonObjects = New List(Of Person)() From {
	New Person With {
		.Id = 1,
		.IsLiving = True,
		.Name = "John"
	},
	New Person With {
		.Id = 2,
		.IsLiving = True,
		.Name = "Steve"
	},
	New Person With {
		.Id = 3,
		.IsLiving = True,
		.Name = "James"
	}
}

5.2. Schreiben in eine CSV-Datei in C# mit Standardeinstellungen

CsvHelper hat sich als Standardmethode zum Schreiben von CSV in C# mit der CSVWriter-Methode etabliert, und es ist sehr einfach zu verwenden:

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

Using writer = New StreamWriter("filePersons.csv")
Using csv = New CsvWriter(writer, CultureInfo.InvariantCulture)
	csv.WriteRecords(myPersonObjects)
End Using
End Using

5.3. Anhängen von Daten

Wir müssen bedenken, dass bei jedem Ausführen unseres Programms alte CSV-Dateien überschrieben werden. Manchmal möchten wir, dass die Daten am Ende einer Datei hinzugefügt werden, anstatt bestehende Daten zu überschreiben. CSVWriter bietet keine Methode, dies zu tun, da das Öffnen/Schreiben einer Datei nicht die Aufgabe von CSVWriter mit bereitgestelltem Trennzeichen ist. Wir können dies erreichen, indem wir ein FileStream verwenden und dann unseren StreamWriter mit diesem FileStream konstruieren. Obwohl dies nicht in den Geltungsbereich dieses Artikels fällt, werde ich Ihnen zeigen, wie Sie dies tun, da es ein integraler Bestandteil jeder Anwendung ist.

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

Dim configPersons = New CsvConfiguration(CultureInfo.InvariantCulture) With {.HasHeaderRecord = False}
Using stream = File.Open("filePersons.csv", FileMode.Append)
Using writer = New StreamWriter(stream)
Using csv = New CsvWriter(writer, configPersons)
	csv.WriteRecords(myPersonObjects)
End Using
End Using
End Using

Das Anfügen an eine bestehende Datei ist jedoch schwierig, da die Reihenfolge beim Anhängen geändert werden könnte oder neue Eigenschaften hinzugefügt werden könnten. Wir sollten sicherstellen, dass wir dies beim Anhängen berücksichtigen.

Zusammenfassung

IronXL ist eine umfassende Bibliothek, die alles bietet, was man braucht, um eine Excel-Datei zu manipulieren. Es bietet die Möglichkeit, verschiedene Formate in XLSX umzuwandeln und auch von XLSX in andere Formate, wie CSV. Diese Umwandlung bietet den Nutzern die Flexibilität, andere Dateiformate mit Leichtigkeit zu manipulieren.

Auf der anderen Seite arbeitet CSVWriter nur mit CSV-Dateiformaten und sehr begrenzten Optionen. Nutzer können nicht zwischen verschiedenen Dateiformaten wechseln, während sie mit IronXL können. Alle Beispielcodes finden Sie in den CsvHelper-Dokumentationsdateien. Dieses Dokument bietet Richtlinien, wie CSVWriter in Ihrem Projekt verwendet werden kann.

Abschluss

IronXL hat einen klaren Vorteil gegenüber CSVHelper.CSVWriter, da es die Arbeit mit mehreren Formaten unterstützt. Darüber hinaus können Sie Formeln und Stile nach Ihrem Wunsch anwenden, während CsvHelper nur das Lesen und Schreiben von CSV-Dateien erlaubt, und das mit eingeschränkten Optionen. Außerdem können Sie keine neuen Datensätze in eine bestehende CSV-Datei anhängen, da dabei nur frühere Einträge überschrieben werden.