Una comparación entre IronXL y CsvHelper

Conjunto de características de IronXL

• Cargar, leer y editar datos — de XLS/XLSX/CSV/TSV
• Guardar y exportar — a XLS/XLSX/CSV/TSV/JSON
• Rangos — sintaxis fácil de usar WorkSheet["A1:B10"]. Combina y crea rangos de manera intuitiva.
• Ordenar — ordenar rangos, columnas y filas.
• Estilos — estilos visuales de celdas, fuente, tamaño, patrón de fondo, borde, alineación y formatos de número.

Funciones de CsvHelper

• Rápido: compila clases en el vuelo para un rendimiento extremadamente rápido
• Flexible: conservador al escribir, liberal al leer
• Fácil de usar: leer y escribir son tan simples como GetRecords() y WriteRecords(records)
• Altamente configurable
• Modo Linux
• Uso de memoria baja

2.1. Uso de Visual Studio con paquetes NuGet

Visual Studio proporciona el Administrador de Paquetes NuGet para instalar paquetes NuGet en tus proyectos. Puedes acceder a él a través del menú Proyecto, o haciendo clic derecho en tu proyecto en el Explorador de Soluciones.

Seleccionar-Administrar-Paquete-NuGet

• Ahora, desde la pestaña de navegación -> busca IronXL.Excel -> Instalar

Buscar IronXL

• Y hemos terminado.

2.2. Descargar el paquete NuGet directamente

Esto se puede hacer visitando el sitio de NuGet directamente y descargando el paquete. Los pasos son:

• Navega a https://www.nuget.org/packages/IronXL.Excel
• Selecciona "Descargar Paquete"
• Haz doble clic en el paquete descargado
• El paquete será instalado
• Recarga tu proyecto de Visual Studio y comienza a usarlo

2.3. Instalación manual con la DLL

Otra forma de descargar e instalar la Biblioteca IronXL para C# es utilizar los siguientes pasos para instalar el paquete NuGet de IronXL a través del Símbolo del Sistema para Desarrolladores.

• Abre el Símbolo del sistema del desarrollador, generalmente encontrado en la carpeta de Visual Studio.
• Escribe el siguiente comando: PM> Install-Package IronXL.Excel
• Presiona Enter
• Esto descargará e instalará el paquete
• Recarga tu proyecto de Visual Studio y comienza a usarlo

2.4. Agregar directivas de uso necesarias

1. En el Explorador de Soluciones, haz clic derecho en el archivo Program.cs y luego haz clic en Ver Código.
2. Añade las siguientes directivas de uso en la parte superior del archivo de código:

using IronXL;

using IronXL;

Imports IronXL

¡Todo listo! IronXL está descargado, instalado y listo para usar. Sin embargo, antes de eso, debemos instalar CsvHelper.

3.1. Uso de la consola del administrador de paquetes NuGet

Para descargar e instalar la Biblioteca CsvHelper C#, utiliza los siguientes pasos para instalar el paquete NuGet a través del Símbolo del sistema del Desarrollador.

• Abre el Símbolo del sistema del desarrollador, generalmente encontrado en la carpeta de Visual Studio.
• Escribe el siguiente comando: PM> Install-Package CsvHelper -Version 27.2.1
• Presiona Enter
• Esto descargará e instalará el paquete
• Recarga tu proyecto de Visual Studio y comienza a usarlo

3.2. Descarga directa

Descarga desde el sitio de NuGet: https://www.nuget.org/packages/CsvHelper.

4.1. Convertir un archivo CSV a formato Excel

El proceso es bastante simple y fácil. Generalmente se hace con una línea de código.

CSV a formatos de Excel:

// 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. Leer y manipular archivos CSV convertidos con IronXL

La clase WorkBook de IronXL representa una hoja de Excel. Para abrir un archivo de Excel usando C#, utilizamos WorkBook.Load y especificamos la ruta del archivo de Excel (.xlsx). La siguiente línea de código se utiliza para abrir el archivo para lectura:

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

Cada WorkBook puede contener múltiples objetos WorkSheet. Estos representan las hojas de trabajo en el documento de Excel. Si el libro contiene hojas de trabajo, recupéralas por nombre de la siguiente manera:

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

Código para leer los valores de las celdas:

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

Después de cargar y leer el libro de trabajo y la hoja de trabajo, se puede usar el siguiente ejemplo de código para realizar cambios en las fórmulas o aplicarlas a celdas específicas. El código es el siguiente:

// 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. Guardar el documento de Excel como archivo CSV

Escribir archivos CSV es un proceso fácil con IronXL. El siguiente código simplemente guarda el archivo de Excel en formato CSV utilizando el método SaveAsCsv.

// 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. Leer archivos CSV con CsvHelper

Este es el archivo CSV de ejemplo, tiene tres columnas de texto y una columna de número.

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

Mapearemos cada fila en un objeto de tipo Person.

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

El código para leer nuestro archivo CSV está abajo.

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

El tipo de data es IEnumerable<Person>. CsvHelper mapeará automáticamente cada columna a la propiedad con el mismo nombre. Por ejemplo, el valor en la columna FirstName se mapeará a Person.FirstName. Entonces podemos iterar data y acceder a los valores en cada fila.

5.2. Convertir datos en archivos CSV de un tipo a otro

Los archivos CSV contienen datos de texto. Por ejemplo, la columna de edad es un valor entero y el archivo CSV contiene solo texto. CsvHelper puede convertir datos de cadenas a tipos estándar de .NET (Boolean, Int32, Int64, Enum). En nuestro caso, tenemos un tipo de dato bool IsActive, que solo puede tener un True/False, y contiene valores no estándar. Se puede convertir creando un convertidor personalizado. La estilización del código es la siguiente:

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

Aunque bool es un tipo estándar de .NET, el convertidor por defecto solo puede manejar valores True/False, mientras que nuestro archivo CSV tiene Yes/No. Aquí, necesitamos subclasificar el DefaultTypeConverter, luego sobrescribir el método ConvertFromString.

Resumen

IronXL es una biblioteca completa que ofrece todo lo que necesitas para poder manipular un archivo de Excel. Es fácil de usar y te proporciona la facilidad de convertir varios formatos a XLSX, así como de XLSX a otros formatos, como CSV. Esta interconversión ofrece al usuario flexibilidad para trabajar con varios formatos de archivo con facilidad.

Por otro lado, CsvHelper está diseñado específicamente para trabajar con formatos de archivo CSV, lo que significa que solo puede manejar archivos CSV. Todos los ejemplos de código se pueden encontrar en los archivos de documentación de CsvHelper. La documentación te brinda pautas sobre cómo usar CsvHelper en tu proyecto.

Conclusión

IronXL tiene una clara ventaja sobre CsvHelper, ya que soporta a los usuarios que trabajan con múltiples formatos. Además, puedes aplicar fórmulas y estilos según tu elección, mientras que CsvHelper solo permite la lectura y escritura de archivos CSV con opciones limitadas. Tampoco puedes agregar nuevos registros a un archivo CSV existente, ya que simplemente sobrescribe las entradas anteriores.