Uma comparação entre IronXL e CsvWriter

Conjunto de Recursos do IronXL

• Carregar, ler e editar dados — de XLS/XLSX/CSV/TSV
• Salvar e exportar — para XLS/XLSX/CSV/TSV/JSON
• Intervalos — fácil de usar a sintaxe WorkSheet ["A1:B10"]. Combine e crie intervalos de forma intuitiva.
• Ordenação — ordenar intervalos, colunas e linhas.
• Estilos — estilos visuais de célula, fonte, tamanho, padrão de fundo, borda, alinhamento e formatos de números.

Características do CsvWriter

• Rápido: compila classes instantaneamente para desempenho extremamente rápido
• Flexível: conservador ao escrever, liberal ao ler
• Fácil de usar: leitura e escrita são tão simples como GetRecords<t>() e WriteRecords(records)
• Altamente configurável
• Modo Linux
• Baixo uso de memória

2.1. Usando o Visual Studio com pacotes NuGet

O Visual Studio fornece o Gerenciador de Pacotes NuGet para instalar pacotes NuGet em seus projetos. Você pode acessá-lo através do Menu Projeto, ou clicando com o botão direito do mouse no seu projeto no Solution Explorer.

*Selecione-Gerenciar-Pacote-NuGet*

• Agora, na aba de navegação -> procure por IronXl.Excel -> Instalar

*Pesquise por IronXL*

• E terminamos.

2.2. Baixar o Pacote NuGet Diretamente

Isso pode ser feito visitando o site do NuGet diretamente e baixando o pacote. Os passos são:

• Navigate tohttps://www.nuget.org/packages/IronXl.Excel
• Selecione "Download Package"
• Dê um duplo clique no pacote baixado
• O pacote será instalado
• Recarregue seu projeto do Visual Studio e comece a usá-lo

2.3. Instalar Manualmente com o DLL

Outra maneira de baixar e instalar a biblioteca C# IronXL é usar os seguintes passos para instalar o pacote IronXLNuGet através do Developer Command Prompt.

• Abra o Developer Command Prompt— geralmente encontrado na pasta do Visual Studio.
• Digite o seguinte comando:

  Install-Package IronXl.Excel

• Pressione Enter
• Isto irá baixar e instalar o pacote
• Recarregue seu projeto do Visual Studio e comece a usá-lo

2.4. Adicionar Diretivas Using Necessárias

1. No Solution Explorer, clique com o botão direito do mouse no arquivo Program.cs e, em seguida, clique em Ver Código.
2. Adicione as seguintes diretivas using ao topo do arquivo de código:

using IronXL;

using IronXL;

Tudo pronto! IronXL está baixado, instalado e pronto para uso. No entanto, antes disso, devemos instalar o CsvHelper.

3.1. Usando o Console do Gerenciador de Pacotes NuGet

Para trabalhar com CSVWriter, você precisa baixar e instalar a biblioteca C# CsvHelper. Para isso, use os seguintes passos para instalar o pacote NuGet através do Developer Command Prompt.

• Abra o Developer Command Prompt— geralmente encontrado na pasta do Visual Studio.
• Digite o seguinte comando:

  Install-Package CsvHelper -Version 27.2.1

• Pressione Enter
• Isto irá baixar e instalar o pacote
• Recarregue seu projeto do Visual Studio e comece a usá-lo
• Verifique o detalhe do método CsvHelper.CsvWriter para implementação

3.2. Download Direto

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

4.1. Convertendo um Arquivo CSV para o Formato Excel

O processo é bastante simples e fácil. Geralmente é feito com uma linha de código.

CSV para formatos 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");

4.2. Ler e Manipular Arquivos CSV Convertidos usando IronXL

A classe IronXLWorkBook representa uma planilha do Excel. Para abrir um arquivo Excel usando C#, usamos WorkBook.Load e especificamos o caminho do arquivo Excel (.xlsx). O seguinte código de uma linha é usado para abrir o arquivo para leitura:

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

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

Cada WorkBook pode conter múltiplos objetos WorkSheet. Estes representam as planilhas no documento Excel. Se o workbook contém planilhas, recupere-as pelo nome da seguinte forma:

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

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

Código para leitura dos valores das células:

// 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);
}

Após carregar e ler o workbook e a worksheet, o seguinte exemplo de código pode ser usado para fazer alterações em fórmulas ou aplicar fórmulas a células específicas. O código é o seguinte:

// 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. Salvando o documento Excel de volta para o Arquivo CSV

Escrever arquivos CSV é um processo fácil com o IronXL. O seguinte código simplesmente salva o arquivo Excel no formato CSV usando o método 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

5.1. Criar uma Aplicação de Console Simples

Crie uma aplicação de console CSVWriter simples com separador fornecido usando o Visual Studio. Uma vez criado o projeto, o próximo passo é criar uma classe Person:

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; }
}

Dentro do método Main, vamos agora fazer uma lista de objetos Person que escreveremos no arquivo 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" }
};

5.2. Escrevendo em um Arquivo CSV em C# com Configurações Padrão

CsvHelper emergiu como a maneira padrão de escrever CSV em C# usando o método CSVWriter, e é muito fácil de usar:

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);
}

5.3. Acrescentando Dados

Precisamos ter em mente que toda vez que executarmos nosso programa, os arquivos CSV antigos serão sobrescritos. Às vezes, queremos que os dados sejam acrescentados ao final de um arquivo, em vez de sobrescrever dados existentes. CSVWriter não fornece um método para fazer isso, pois abrir/gravar um arquivo não é responsabilidade do CSVWriter com separador fornecido. Podemos conseguir isso usando um FileStream e, em seguida, construir nosso StreamWriter usando esse FileStream. Embora isso não esteja dentro do escopo deste artigo, eu vou te mostrar como fazer isso, pois é parte integrante de qualquer aplicação.

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);
}

Acrescentar a um arquivo existente é complicado, no entanto, pois a ordenação pode ser alterada quando acrescentamos, ou podemos ter adicionado novas propriedades. Devemos garantir levar isso em conta ao acrescentar.

Resumo

IronXL é uma biblioteca completa que oferece tudo o que você precisa para manipular um arquivo Excel. Ela fornece a facilidade de converter vários formatos para XLSX e também de XLSX para outros formatos, como CSV. Essa interconversão oferece aos usuários a flexibilidade de manipular outros formatos de arquivo com facilidade.

Por outro lado, o CSVWriter trabalha apenas com formatos de arquivo CSV e com opções muito limitadas. Os usuários não podem alternar entre diferentes formatos de arquivo, enquanto com o IronXL eles podem. Todos os exemplos de código podem ser encontrados nos arquivos de documentação do CsvHelper. Este documento fornece diretrizes sobre como usar o CSVWriter em seu projeto.

Conclusão

IronXL tem uma clara vantagem sobre CSVHelper.CSVWriter, pois suporta o trabalho com múltiplos formatos. Além disso, você pode aplicar fórmulas e estilos de acordo com sua escolha, enquanto CsvHelper só permite a leitura e escrita de arquivos CSV, e com opções limitadas. Além disso, você não pode acrescentar novos registros a um arquivo CSV existente, pois ele simplesmente sobrescreve as entradas anteriores.