Uma comparação entre IronXL e ClosedXML

Conjunto de Recursos do IronXL

• Carregar, ler e editar dados de XLS/XLSX/CSV/TSV
• Salvar e exportar para XLS/XLSX/CSV/TSV/JSON
• Objetos System.Data: Trabalhe com planilhas Excel como objetos System.Data.DataSet e System.Data.DataTable.
• Fórmulas: Trabalhe com fórmulas Excel, recalculadas cada vez que uma folha é editada.
• Intervalos: Sintaxe fácil de usar WorkSheet ["A1:B10"]. Combine e crie intervalos de forma intuitiva.
• Ordenação: Ordenar intervalos, colunas e linhas.
• Estilo: Estilos visuais das células, fonte, tamanho, padrão de fundo, borda, alinhamento e formatos numéricos.

Mais recursos do IronXL podem ser explorados usando este link.

Características do ClosedXML

ClosedXML tem uma interface fácil de usar com extensas funções de API para lidar com a criação e extração de conteúdo no Excel. Com essas chamadas de API e pull requests, você pode modificar cada pequeno detalhe em uma planilha ou livro de Excel. Todos os recursos estão listados abaixo:

1. Fórmulas
2. Validação
3. Hiperlinks
4. Proteção (nível de Planilha e Célula)
5. Formatação Condicional
6. Congelar Painéis
7. Tabelas
8. Intervalos
9. Estilização
10. Configuração de Página (Impressão)
11. Filtros Automáticos
12. Comentários

O restante deste artigo continua da seguinte forma:

1. Crie uma Aplicação de Console
2. Instalação da Biblioteca C# IronXL
3. Instalação ClosedXML
4. Crie e Salve um novo Livro e Planilha Excel
5. Ler Arquivo Excel
6. Trabalhando com Fórmulas Excel
7. Licenciamento
8. Resumo e Conclusão

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.

Gerenciador de Pacotes

• Em seguida, na aba Procurar > pesquise por IronXl.Excel > Instalar

Instalação NuGet IronXL

• E pronto.

2.2. Instalando manualmente o DLL

Outra forma de baixar e instalar a Biblioteca C# IronXL é seguir as etapas abaixo para instalar o pacote NuGet IronXL através do Prompt de Comando do Desenvolvedor.

• Abra o Prompt de Comando do Desenvolvedor — geralmente encontrado na pasta do Visual Studio.

Digite o seguinte comando:

Install-Package IronXl.Excel

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

2.3. Adicionar Diretivas de Uso Necessárias

1. No Explorador de Soluções, clique com o botão direito no arquivo Program.cs e depois 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 ClosedXML.

3.1. Usando o Gerenciador/Console de Pacotes NuGet

Abra o Gerenciador de Pacotes NuGet do explorador de soluções do projeto, procure por ClosedXML e clique em instalar.

Instalação NuGet ClosedXML

Ou:

• Abra o Prompt de Comando do Desenvolvedor — geralmente encontrado na pasta do Visual Studio.

Digite o seguinte comando:

Install-Package ClosedXML

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

3.2. Adicionar Diretivas de Uso Necessárias

1. No Explorador de Soluções, clique com o botão direito no arquivo Program.cs e depois clique em Ver Código.
2. Adicione as seguintes diretivas using ao topo do arquivo de código:

using ClosedXML.Excel;

using ClosedXML.Excel;

4.1. Novo Workbook e Planilhas Excel usando IronXL

Não poderia ser mais fácil criar um novo Workbook Excel usando IronXL. Basta uma linha de código. Sim, realmente. Adicione o seguinte código à sua função static void main no arquivo Program.cs:

// Create a new Excel workbook using IronXL
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Create a new Excel workbook using IronXL
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

Ambos os formatos de arquivo XLS (versão de arquivo do Excel mais antiga) e XLSX (versão de arquivo atual e mais nova) podem ser criados com IronXL.

E é ainda mais simples criar uma Planilha padrão:

// Create a new worksheet within the workbook
var worksheet = workbook.CreateWorkSheet("IronXL Features");

// Create a new worksheet within the workbook
var worksheet = workbook.CreateWorkSheet("IronXL Features");

Você pode agora usar a variável worksheet para definir valores de células e fazer quase tudo que um arquivo Excel pode fazer.

// Add data and styles to the new worksheet
worksheet["A1"].Value = "Hello World";
worksheet["A2"].Style.BottomBorder.SetColor("#ff6600");
worksheet["A2"].Style.BottomBorder.Type = IronXl.Styles.BorderType.Double;

// Add data and styles to the new worksheet
worksheet["A1"].Value = "Hello World";
worksheet["A2"].Style.BottomBorder.SetColor("#ff6600");
worksheet["A2"].Style.BottomBorder.Type = IronXl.Styles.BorderType.Double;

Salve o arquivo Excel:

// Save the spreadsheet
workbook.SaveAs("NewExcelFile.xlsx");

// Save the spreadsheet
workbook.SaveAs("NewExcelFile.xlsx");

O arquivo de saída se parece com o seguinte:

saída `NewExcelFile`

4.2. Novo Workbook e Planilhas Excel usando ClosedXML

Você também pode criar arquivos Excel (.xlsx, .xlsm) facilmente usando ClosedXML. O código a seguir é um exemplo típico que serve para gerar um arquivo Excel simples e salvá-lo. Você pode adicionar uma nova planilha de exemplo ao seu workbook e atribuir valores às células em sua aplicação Excel.

// Create a new empty Excel file
var workbook = new XLWorkbook();

// Create a new worksheet and set cell A1 value to 'Hello world!'
var worksheet = workbook.Worksheets.Add("ClosedXML Features");
worksheet.Cell("A1").Value = "Hello world!";

// Save to XLSX file
workbook.SaveAs("Spreadsheet.xlsx");

// Create a new empty Excel file
var workbook = new XLWorkbook();

// Create a new worksheet and set cell A1 value to 'Hello world!'
var worksheet = workbook.Worksheets.Add("ClosedXML Features");
worksheet.Cell("A1").Value = "Hello world!";

// Save to XLSX file
workbook.SaveAs("Spreadsheet.xlsx");

O arquivo de saída se parece com o seguinte:

Saída do Arquivo de Planilha

5.1. Ler Arquivos Excel usando IronXL

A classe IronXL WorkBook representa uma planilha do Excel. Para abrir um arquivo Excel usando C#, usamos WorkBook.Load e especificamos o caminho do arquivo (.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 ter várias planilhas no documento do Excel. Se o workbook contiver várias 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);
}

5.2. Ler Arquivos Excel usando ClosedXML

ClosedXML permite a leitura de arquivos previamente criados da sua aplicação C#. Você pode importar um arquivo Excel usando o seguinte código.

// Import Excel file from file's path
var workbook = new XLWorkbook("SimpleTemplate.xlsx");

// Read worksheet from workbook using sheet number
var worksheet1 = workbook.Worksheet(1);

// Read cell value from the first sheet
var data = worksheet1.Cell("A1").GetValue<string>();

// Display on screen
Console.WriteLine(data);

// Import Excel file from file's path
var workbook = new XLWorkbook("SimpleTemplate.xlsx");

// Read worksheet from workbook using sheet number
var worksheet1 = workbook.Worksheet(1);

// Read cell value from the first sheet
var data = worksheet1.Cell("A1").GetValue<string>();

// Display on screen
Console.WriteLine(data);

6.1. Trabalhar com Fórmulas do Excel usando IronXL

Após carregar o workbook e a planilha, o seguinte exemplo de código pode ser usado para fazer alterações nas fórmulas ou ser aplicado 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 recalculating 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 recalculating all formula values in all sheets
workbook.EvaluateAll();

Você também pode recuperar fórmulas e seus valores:

// Get the formula's calculated value e.g. "52"
string formulaValue = worksheet["G30"].Value;

// Get the formula as a string e.g. "Max(C3:C7)"
string formulaString = worksheet["G30"].Formula;

// Save your changes with updated formulas and calculated values
workbook.Save();

// Get the formula's calculated value e.g. "52"
string formulaValue = worksheet["G30"].Value;

// Get the formula as a string e.g. "Max(C3:C7)"
string formulaString = worksheet["G30"].Formula;

// Save your changes with updated formulas and calculated values
workbook.Save();

6.2. Trabalhando com Fórmulas Excel usando ClosedXML

ClosedXML não suporta todas as fórmulas e você provavelmente receberá um erro desagradável se a fórmula não for suportada ou se houver um erro na fórmula. Por favor, teste suas fórmulas antes de ir para produção. Vamos dar uma olhada em como usá-las.

// Set formulas
worksheet.Cell("A1").Value = "Hello World!";
worksheet.Cell("A2").FormulaA1 = "=MID(A1, 7, 5)";

// You can use Evaluate function to directly calculate formula
var sum = worksheet.Evaluate("SUM(B1:B7)");

// Force recalculation
worksheet.RecalculateAllFormulas();

// Save Excel file
workbook.SaveAs("Formula Calculation.xlsx");

// Set formulas
worksheet.Cell("A1").Value = "Hello World!";
worksheet.Cell("A2").FormulaA1 = "=MID(A1, 7, 5)";

// You can use Evaluate function to directly calculate formula
var sum = worksheet.Evaluate("SUM(B1:B7)");

// Force recalculation
worksheet.RecalculateAllFormulas();

// Save Excel file
workbook.SaveAs("Formula Calculation.xlsx");

A propriedade FormulaA1 refere-se à célula A1. Se você estiver referenciando outra célula, deve adicioná-la à propriedade Formula. Por exemplo, FormulaC2.

Resumo

IronXL é uma biblioteca completa que oferece tudo o que você precisa para manipular um arquivo Excel. IronXL permite que desenvolvedores leiam, gerem e editem Excel (e outros arquivos de planilha) em aplicações e sites .NET. Ela fornece uma abordagem rápida e natural para trabalhar com Excel e outros arquivos de planilha em C#.

ClosedXML é uma biblioteca .NET para ler e escrever arquivos Excel, o que torna mais fácil para desenvolvedores criar arquivos Excel 2007+. Ela fornece uma maneira agradável e orientada a objetos para manipular os arquivos (semelhante ao VBA) sem lidar com as dificuldades dos Documentos XML. Pode ser usada por qualquer linguagem .NET como C# e Visual Basic (VB). Ela fornece recursos do OpenXML, mas ainda alguns não estão implementados. Por exemplo, Macros, Inserção e Gráficos.

Conclusão

IronXL também é útil em outras operações do Excel, como formatos de dados de célula, ordenação e estilo de células. Ele também pode trabalhar com planilhas do Excel como System.Data.DataSet e System.Data.DataTable. Ele suporta aplicativos de console, servidor web e baseados em desktop. Também é suportado em todas as plataformas de SO.

ClosedXML é uma biblioteca leve para leitura, manipulação e escrita de aplicativos Excel usando a API OpenXML, que é rápida e fácil de implementar. Ajuda em todas as principais operações do Excel, como Configuração de Página, Congelar Painéis, Hiperlinks, Tabelas e Formatação Condicional. Não tem sobrecarga ou problemas de baixo desempenho.

Em comparação, IronXL e ClosedXML são rápidos e precisos quando se trata de planilhas do Excel. Eles não precisam da instalação ou licença do Microsoft Office ao criar relatórios do Excel. No entanto, IronXL tem uma vantagem sobre ClosedXML, pois ClosedXML não é seguro para threads. IronXL é fácil de usar e oferece a facilidade de converter outros formatos para XLSX e também de XLSX para outros formatos, como CSV e HTML. ClosedXML não permite essa conversão. Essa interconversão permite que os usuários trabalhem com facilidade com outros formatos de arquivo.

Agora você pode obter cinco produtos Iron pelo preço de apenas dois no pacote lite para 1 desenvolvedor($suitePrice) e ilimitado por $unlimitedSuitePrice e economizar até 60%.