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.
• Estilização: estilos visuais da célula, fonte, tamanho, padrão de fundo, borda, alinhamento e formatos de número .

Mais recursos doIronXLpodem 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

A tabela abaixo apresenta uma comparação lado a lado das principais diferenças entreIronXLeClosedXMLdiscutidas ao longo deste artigo.

IronXL é gratuito para uso em desenvolvimento; Um período de teste gratuito de 30 dias desbloqueia o conjunto completo de recursos para avaliação.

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. Qual biblioteca você deve escolher?

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. Não 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;

Imports IronXL

Tudo pronto!IronXLestá baixado, instalado e pronto para uso. Não 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 porClosedXMLe 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. Não 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;

Imports ClosedXML.Excel

4.1. Novo Workbook e Planilhas Excel usando IronXL

Criar uma nova planilha do Excel usando oIronXLrequer apenas uma linha de código. Adicione o seguinte à 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);

' Create a new Excel workbook using IronXL
Dim workbook As 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");

' Create a new worksheet within the workbook
Dim 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;

' 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");

' 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");

' Create a new empty Excel file
Dim workbook = New XLWorkbook()

' Create a new worksheet and set cell A1 value to 'Hello world!'
Dim 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 classeIronXLWorkBook 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");

' Load WorkBook
Dim 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");

' Open Sheet for reading
Dim 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);
}

' 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

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

' Import Excel file from file's path
Dim workbook = New XLWorkbook("SimpleTemplate.xlsx")

' Read worksheet from workbook using sheet number
Dim worksheet1 = workbook.Worksheet(1)

' Read cell value from the first sheet
Dim data = worksheet1.Cell("A1").GetValue(Of 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();

' 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();

' Get the formula's calculated value e.g. "52"
Dim formulaValue As String = worksheet("G30").Value

' Get the formula as a string e.g. "Max(C3:C7)"
Dim formulaString As String = worksheet("G30").Formula

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

6.2. Trabalhando com Fórmulas Excel usando ClosedXML

O mecanismo de fórmulas doClosedXMLabrange muitas funções comuns, embora nem todas as fórmulas do Excel estejam dentro de seu escopo atual. Se uma fórmula não for suportada ou contiver um erro, a biblioteca lançará uma exceção. Vale a pena testar suas fórmulas antes de implantá-las em 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");

' 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
Dim 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 fazendo referência a outra célula, você deve adicioná-la à propriedade Formula. Por exemplo, FormulaC2.

Resumo

IronXL é uma biblioteca completa para manipulação de arquivos Excel. OIronXLpermite que desenvolvedores leiam, gerem e editem arquivos do Excel (e outras planilhas) em aplicativos e sites .NET . É distribuído como um único pacote NuGet com suporte integrado para XLS, XLSX, CSV , TSV, HTML e JSON — abrangendo conversão de formato, fórmulas, formatação e integração com System.Data sem dependências adicionais.

ClosedXML é uma biblioteca .NET para ler e escrever arquivos Excel, o que torna mais fácil para desenvolvedores criar arquivos Excel 2007+. Ele oferece uma maneira limpa e orientada a objetos de manipular os arquivos (semelhante ao VBA) sem lidar com as complicações dos documentos XML. Pode ser usada por qualquer linguagem .NET como C# e Visual Basic (VB). Ele oferece muitos recursos do OpenXML, embora algumas funcionalidades — como macros, incorporação e gráficos — estejam fora de seu escopo atual.

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 gravação de arquivos Excel usando a API OpenXML, e sua implementação é simples. Ele lida bem com muitas operações comuns do Excel — Configuração de Página, Congelar Painéis, Hiperlinks, Tabelas e Formatação Condicional, entre outras — e apresenta uma sobrecarga mínima de desempenho.

Tanto oIronXLquanto oClosedXMLlidam com operações em planilhas do Excel de forma confiável e nenhum deles requer a instalação do Microsoft Office. A divergência entre as duas bibliotecas reside no escopo arquitetônico: oIronXLoferece segurança de threads integrada — uma consideração importante para cargas de trabalho paralelas ou do lado do servidor — enquanto oClosedXMLnão foi projetado para acesso simultâneo. OIronXLtambém suporta a interconversão de formatos (XLSX para e de CSV, HTML e JSON), uma funcionalidade que está fora do conjunto de recursos principais do ClosedXML. Para equipes cujos fluxos de trabalho envolvem a importação ou exportação em vários formatos de arquivo, essa cobertura de formatos mais ampla reduz a necessidade de ferramentas adicionais de terceiros.

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%.

Pronto para ver como oIronXLse encaixa no seu projeto? Baixe a versão de avaliação gratuita de 30 dias para explorar todos os recursos abordados nesta comparação.