Une comparaison entre IronXL et CsvWriter

Ensemble de fonctionnalités d'IronXL

• Charger, lire et modifier des données — à partir de fichiers XLS/XLSX/CSV/TSV
• Enregistrement et exportation — aux formats XLS/XLSX/CSV/TSV/JSON
• Plages — syntaxe WorkSheet ["A1:B10"] facile à utiliser. Combinez et créez des gammes intuitivement.
• Tri — trier les plages, les colonnes et les lignes.
• Mise en forme — styles visuels des cellules, police, taille, motif d'arrière-plan, bordure, alignement et formats numériques.

Fonctionnalités de CsvWriter

• Rapide : compile les classes à la volée pour des performances extrêmement rapides
• Flexible : conservateur à l'écrit, libéral à la lecture
• Facile à utiliser : la lecture et l'écriture sont aussi simples que GetRecords () et WriteRecords(records)
• Hautement configurable
• Mode Linux
• Faible utilisation de la mémoire

2.1. Utilisation de Visual Studio avec les packages NuGet

Visual Studio fournit le gestionnaire de paquets NuGet pour installer des paquets NuGet dans vos projets. Vous pouvez y accéder via le Menu Projet, ou en cliquant avec le bouton droit sur votre projet dans l'Explorateur de solutions.

Sélectionner-Gérer-Package-NuGet

• Maintenant, depuis l'onglet Parcourir -> recherchez IronXL.Excel -> Installer

Rechercher IronXL

Et voilà, c'est terminé.

2.2. Télécharger directement le package NuGet

Cela peut être fait en visitant directement le site de NuGet et en téléchargeant le paquet. Les étapes sont :

• Navigate tohttps://www.nuget.org/packages/IronXL.Excel
• Sélectionnez " Télécharger le package " Double-cliquez sur le package téléchargé. Le paquet sera installé. Rechargez votre projet Visual Studio et commencez à l'utiliser.

2.3. Installation manuelle avec la DLL

Une autre façon de télécharger et d'installer la bibliothèque IronXL C# consiste à suivre les étapes suivantes pour installer le package IronXLNuGet via l'invite de commandes développeur.

• Ouvrez l'invite de commandes développeur — généralement située dans le dossier Visual Studio.
• Saisissez la commande suivante :

  Install-Package IronXL.Excel

  Appuyez sur Entrée. Cela téléchargera et installera le package Rechargez votre projet Visual Studio et commencez à l'utiliser.

2.4. Ajouter les directives using nécessaires

1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier Program.cs, puis cliquez sur Afficher le code.
2. Ajoutez les directives using suivantes en haut du fichier de code :

using IronXL;

using IronXL;

Imports IronXL

Tout est fait ! IronXL est téléchargé, installé et prêt à l'emploi. Cependant, avant cela, nous devons installer CsvHelper.

3.1. Utilisation de la console du gestionnaire de packages NuGet

Pour utiliser CSVWriter, vous devez télécharger et installer la bibliothèque C# CsvHelper. Pour ce faire, suivez les étapes suivantes pour installer le package NuGet via l'invite de commandes développeur.

• Ouvrez l'invite de commandes développeur — généralement située dans le dossier Visual Studio.
• Saisissez la commande suivante :

  Install-Package CsvHelper -Version 27.2.1

  Appuyez sur Entrée. Cela téléchargera et installera le package Rechargez votre projet Visual Studio et commencez à l'utiliser.

• Consultez les détails de la méthode CsvHelper.CsvWriter pour l'implémentation.

3.2. Téléchargement direct

Download from the NuGet website: https://www.nuget.org/packages/CsvHelper/

4.1. Conversion d'un fichier CSV au format Excel

Le processus est assez simple et facile. Cela se fait généralement avec une seule ligne de code.

Conversion de fichiers CSV en formats Excel :

// 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. Lire et manipuler des fichiers CSV convertis à l'aide d'IronXL

La classe IronXLWorkBook représente une feuille Excel. Pour ouvrir un fichier Excel en utilisant C#, nous utilisons WorkBook.Load et spécifions le chemin d'accès au fichier Excel (.xlsx). La ligne de code suivante permet d'ouvrir le fichier en lecture :

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

Chaque classeur peut contenir plusieurs objets WorkSheet. Ce sont des feuilles de calcul du document Excel. Si le classeur contient des feuilles de calcul, récupérez-les par leur nom comme suit :

// 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 pour lire les valeurs des cellules :

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

Après avoir chargé et lu le classeur et la feuille de calcul, l'exemple de code suivant peut être utilisé pour modifier les formules ou appliquer des formules à des cellules spécifiques. Le code se présente comme suit :

// 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. Enregistrement du document Excel au format CSV

L'écriture de fichiers CSV est un processus simple avec IronXL. Le code suivant enregistre simplement le fichier Excel au format CSV en utilisant la méthode SaveAsCsv.

// 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. Créer une application console simple

Créez une application console simple CSVWriter avec séparateur fourni à l'aide de Visual Studio. Une fois le projet créé, l'étape suivante consiste à créer une classe Personne :

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

Dans la méthode Main, créons maintenant une liste d'objets Person que nous écrirons dans le fichier CSV :

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. Écriture dans un fichier CSV en C# avec les paramètres par défaut

CsvHelper s'est imposé comme la méthode standard pour écrire des fichiers CSV en C# à l'aide de la méthode CSVWriter, et il est très facile à utiliser :

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. Ajout de données

Il faut garder à l'esprit qu'à chaque exécution de notre programme, les anciens fichiers CSV seront écrasés. Parfois, nous souhaitons que les données soient ajoutées à la fin d'un fichier, au lieu d'écraser les données existantes. CSVWriter ne propose pas de méthode pour cela, car l'ouverture/l'écriture d'un fichier avec séparateur fourni n'est pas de sa responsabilité. Nous pouvons y parvenir en utilisant un FileStream, puis en construisant notre StreamWriter à partir de ce FileStream. Bien que cela ne relève pas du champ d'application de cet article, je vais vous montrer comment procéder, car cela fait partie intégrante de toute application.

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

L'ajout à un fichier existant est toutefois délicat, car l'ordre des éléments peut être modifié lors de l'ajout, ou de nouvelles propriétés peuvent avoir été ajoutées. Nous devrions veiller à en tenir compte lors de l'ajout.

Résumé

IronXL est une bibliothèque complète offrant tout le nécessaire pour manipuler un fichier Excel. Elle permet de convertir différents formats en XLSX, et inversement, de XLSX vers d'autres formats, comme CSV. Cette interconversion offre aux utilisateurs une grande flexibilité pour manipuler facilement d'autres formats de fichiers.

En revanche, CSVWriter ne fonctionne qu'avec les formats de fichiers CSV et avec des options très limitées. Les utilisateurs ne peuvent pas passer d'un format de fichier à un autre, contrairement à ce qui est possible avec IronXL. Tous les exemples de code se trouvent dans les fichiers de documentation de CsvHelper. Ce document fournit des instructions sur la manière d'utiliser CSVWriter dans votre projet.

Conclusion

IronXL présente un net avantage sur CSVHelper.CSVWriter, car il prend en charge la gestion de plusieurs formats. De plus, vous pouvez appliquer des formules et des styles selon votre choix, alors que CsvHelper ne permet que la lecture et l'écriture de fichiers CSV, et avec des options limitées. De plus, vous ne pouvez pas ajouter de nouveaux enregistrements à un fichier CSV existant, car cela écrase simplement les entrées précédentes.