IronXL permite criar, ler e exportar arquivos Excel em C#/.NET com apenas algumas linhas de código, sem exigir instalações do Microsoft Office, tornando-o perfeito para startups em rápido crescimento que precisam de capacidades rápidas de integração com Excel.
Neste artigo, vamos explorar o IronXL, uma biblioteca Excel que simplifica o trabalho com documentos Microsoft Excel programaticamente em .NET. Vamos criar um ambiente de planilhas do Excel para ler planilhas do Excel, escrever tabelas do Excel e exportar arquivos de planilha para CSV.
Documentos criados no Microsoft Excel podem ser lidos e convertidos em arquivos CSV usando a biblioteca C# IronXL .NET Excel. IronXL é uma biblioteca de software .NET autônoma que não precisa do Microsoft Office, Microsoft.Office.Interop.Excel ou do Excel Interop instalados. Ele pode ler vários formatos de planilha e não é apenas uma biblioteca estática.
A API simples de C# do IronXL facilita ler várias planilhas, modificar e gerar planilhas Excel em um ambiente .NET. Ele suporta totalmente Xamarin, Linux, macOS, Azure, aplicações .NET Core e .NET Framework.
Para fundadores de startups que precisam de implantação rápida, o IronXL elimina a dependência das instalações do Microsoft Office em servidores de desenvolvimento e produção, reduzindo significativamente a complexidade da infraestrutura e os custos de licenciamento. O suporte multiplataforma da biblioteca garante que suas capacidades de processamento do Excel funcionem perfeitamente, quer você esteja implantando em contêineres Linux, Azure Functions ou servidores Windows tradicionais.
O suporte extenso a formatos significa que você pode converter entre diferentes tipos de arquivos de planilha sem esforço, quer esteja importando dados Excel de uploads de clientes ou exportando para diferentes formatos para várias partes interessadas.
As próximas seções mostram como é simples criar e ler arquivos Excel com a biblioteca IronXL.
Passo 1: Lançar um novo projeto para criar arquivos Excel.
Depois de iniciar o Visual Studio, selecione 'Novo Projeto' no menu 'Arquivo'.
Na caixa de diálogo resultante, selecione os templates de Projeto .NET 'Aplicativo de Console' e clique em 'Próximo'.
Novo projeto
Depois de inserir a localização do novo projeto no campo Localização, você pode inserir qualquer nome de projeto que escolher. Clique no botão Próximo para prosseguir.
Configuração do projeto
Selecionar um .NET Framework usando a opção de drop-down Framework. Aqui, estamos usando o .NET 6.0, a versão suportada a longo prazo. Em seguida, pressione Criar.
Seleção do Framework
Para ambientes de startups, escolher o .NET 6.0 LTS garante estabilidade e suporte a longo prazo, reduzindo a necessidade de atualizações de framework durante fases críticas de crescimento. Esta versão também proporciona excelentes melhorias de desempenho e é totalmente compatível com implantações Docker e Azure Functions.
Adquira a biblioteca IronXL, que é necessária para a solução a seguir. Para fazer isso, insira o seguinte comando no Console do Gerenciador de Pacotes NuGet:
Instalação do IronXL
Outra opção é usar o Gerenciador de Pacotes NuGet para buscar o pacote 'IronXL'. Em seguida, selecione o pacote desejado para download na lista de todos os pacotes NuGet relacionados ao IronXL.
Gerenciador de Pacotes NuGet
O processo de instalação é simples e pode ser concluído em menos de um minuto. Para equipes que usam pipelines CI/CD, o IronXL pode ser facilmente integrado em builds automatizados. Consulte a página de licenciamento para opções de preços amigáveis para startups e veja como aplicar chaves de licença no seu pipeline de implantação.
Com o IronXL, você pode criar novos arquivos Excel com apenas algumas linhas de código! O IronXL pode criar arquivos tanto no formato XLS (formato antigo do Excel) quanto no formato XLSX (formato atual), como mostrado nos exemplos de código abaixo.
using IronXL;
public class IronXLExample
{
public static void Main(string[] args)
{
// Create a new workbook
WorkBook workbook = WorkBook.Create();
// Create a new worksheet named "Sheet1"
WorkSheet worksheet = workbook.CreateWorkSheet("Sheet1");
// Set the value of cell A1
worksheet["A1"].Value = "test";
// Save the workbook to a file
workbook.SaveAs("sample1.xlsx");
}
}Imports IronXL
Public Class IronXLExample
Public Shared Sub Main(ByVal args() As String)
' Create a new workbook
Dim workbook As WorkBook = WorkBook.Create()
' Create a new worksheet named "Sheet1"
Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Sheet1")
' Set the value of cell A1
worksheet("A1").Value = "test"
' Save the workbook to a file
workbook.SaveAs("sample1.xlsx")
End Sub
End ClassO código acima demonstra o uso do pacote IronXL para criar um novo workbook Excel e uma planilha. O método WorkBook.Create() cria uma nova pasta de trabalho, e então a função CreateWorkSheet("Sheet1") cria uma guia de planilha com o nome especificado. As alterações são salvas em um local especificado usando o método SaveAs.
Para cenários mais complexos, você pode adicionar várias planilhas, aplicar formatação de células, definir formatos de dados de células e até mesmo criar gráficos Excel programaticamente:
// Create a workbook with multiple sheets and formatting
WorkBook workbook = WorkBook.Create();
WorkSheet salesSheet = workbook.CreateWorkSheet("Sales");
WorkSheet revenueSheet = workbook.CreateWorkSheet("Revenue");
// Add headers with formatting
salesSheet["A1"].Value = "Product";
salesSheet["B1"].Value = "Quantity";
salesSheet["C1"].Value = "Revenue";
// Apply bold formatting to headers
salesSheet["A1:C1"].Style.Font.Bold = true;
// Add data with number formatting
salesSheet["A2"].Value = "Widget A";
salesSheet["B2"].Value = 150;
salesSheet["C2"].Value = 4500.00;
salesSheet["C2"].FormatString = "$#,##0.00"; // Currency format
// Auto-size columns for better readability
salesSheet.AutoSizeColumn(0);
salesSheet.AutoSizeColumn(1);
salesSheet.AutoSizeColumn(2);
workbook.SaveAs("sales_report.xlsx");' Create a workbook with multiple sheets and formatting
Dim workbook As WorkBook = WorkBook.Create()
Dim salesSheet As WorkSheet = workbook.CreateWorkSheet("Sales")
Dim revenueSheet As WorkSheet = workbook.CreateWorkSheet("Revenue")
' Add headers with formatting
salesSheet("A1").Value = "Product"
salesSheet("B1").Value = "Quantity"
salesSheet("C1").Value = "Revenue"
' Apply bold formatting to headers
salesSheet("A1:C1").Style.Font.Bold = True
' Add data with number formatting
salesSheet("A2").Value = "Widget A"
salesSheet("B2").Value = 150
salesSheet("C2").Value = 4500.0
salesSheet("C2").FormatString = "$#,##0.00" ' Currency format
' Auto-size columns for better readability
salesSheet.AutoSizeColumn(0)
salesSheet.AutoSizeColumn(1)
salesSheet.AutoSizeColumn(2)
workbook.SaveAs("sales_report.xlsx")
Saída do Excel
Para saber mais sobre como criar arquivos Excel, confira este tutorial para criar um em .NET. Você também pode explorar como trabalhar com Excel em C# sem Interop e criar gráficos Excel programaticamente.
Exportar dados para formatos XLSX ou XLS requer apenas algumas linhas de código. Abaixo está o código-fonte que pode ser usado para exportar dados de um arquivo Excel para um formato tabular simples:
using IronXL;
public class ExcelReadExportExample
{
public static void Main(string[] args)
{
// Load an existing Excel file
var workbook = WorkBook.LoadExcel("Demo file.xlsx");
// Get a worksheet from the workbook
WorkSheet workSheet = workbook.GetWorkSheet("Sheet1");
// Read the value of cell A1
string addressVal = workSheet["A1"].ToString();
Console.WriteLine(addressVal);
// Modify the value of cell A2
workSheet["A2"].Value = "test";
// Save the workbook in multiple formats
workbook.SaveAs("export.xlsx");
// Or save as XLS
workbook.SaveAs("export.xls");
// Or save the specific worksheet as an XLS file
workbook.WorkSheets[0].SaveAs("export.xls");
}
}Imports IronXL
Public Class ExcelReadExportExample
Public Shared Sub Main(ByVal args() As String)
' Load an existing Excel file
Dim workbook = WorkBook.LoadExcel("Demo file.xlsx")
' Get a worksheet from the workbook
Dim workSheet As WorkSheet = workbook.GetWorkSheet("Sheet1")
' Read the value of cell A1
Dim addressVal As String = workSheet("A1").ToString()
Console.WriteLine(addressVal)
' Modify the value of cell A2
workSheet("A2").Value = "test"
' Save the workbook in multiple formats
workbook.SaveAs("export.xlsx")
' Or save as XLS
workbook.SaveAs("export.xls")
' Or save the specific worksheet as an XLS file
workbook.WorkSheets(0).SaveAs("export.xls")
End Sub
End ClassNo exemplo anterior, um arquivo Excel existente é carregado usando o método LoadExcel, que aceita o nome e o caminho do arquivo como argumento. O arquivo é então importado para o objeto WorkBook. As planilhas são carregadas usando a função GetWorkSheet especificando o nome da planilha. O valor de uma célula pode ser lido especificando o seu endereço. O código também demonstra a modificação de um valor de planilha e o salvamento da pasta de trabalho em diferentes formatos de arquivo usando o método SaveAs.
O IronXL oferece maneiras flexíveis de selecionar intervalos, ler arquivos CSV e trabalhar com várias estruturas de dados. Aqui está um exemplo expandido mostrando diferentes maneiras de acessar e manipular dados do Excel:
// Load workbook from various sources
WorkBook workbook = WorkBook.Load("data.xlsx");
// Access worksheets in multiple ways
WorkSheet sheet1 = workbook.WorkSheets[0]; // By index
WorkSheet sheet2 = workbook.GetWorkSheet("Sheet2"); // By name
// Read data from ranges
var range = sheet1["A1:C10"];
foreach (var cell in range)
{
Console.WriteLine($"{cell.Address}: {cell.Value}");
}
// Convert to DataTable for easier processing
DataTable dataTable = sheet1.ToDataTable(true);
// Export to various formats
workbook.SaveAs("output.csv"); // CSV format
workbook.SaveAsJson("output.json"); // JSON format
workbook.SaveAsXml("output.xml"); // XML format' Load workbook from various sources
Dim workbook As WorkBook = WorkBook.Load("data.xlsx")
' Access worksheets in multiple ways
Dim sheet1 As WorkSheet = workbook.WorkSheets(0) ' By index
Dim sheet2 As WorkSheet = workbook.GetWorkSheet("Sheet2") ' By name
' Read data from ranges
Dim range = sheet1("A1:C10")
For Each cell In range
Console.WriteLine($"{cell.Address}: {cell.Value}")
Next
' Convert to DataTable for easier processing
Dim dataTable As DataTable = sheet1.ToDataTable(True)
' Export to various formats
workbook.SaveAs("output.csv") ' CSV format
workbook.SaveAsJson("output.json") ' JSON format
workbook.SaveAsXml("output.xml") ' XML format
Saída do console
Uma planilha também pode ser referenciada pelo nome ou valor de índice para exportar dados de uma planilha Excel para um arquivo separado. O IronXL suporta exportação para múltiplos formatos, incluindo CSV, JSON, XML e HTML. Você também pode exportar para DataSet e DataTable para uma integração perfeita com seu pipeline de processamento de dados .NET.
Para equipes iniciantes que precisam se integrar a vários sistemas, as capacidades de exportação do IronXL permitem rápida troca de dados. Você pode carregar Excel de bancos de dados SQL, atualizar registros de banco de dados a partir do Excel ou trabalhar com dados Excel via DataTable para prototipagem rápida e desenvolvimento de MVP.
Desde a criação de novos arquivos até a realização de cálculos precisos, o IronXL tem tudo que você precisa para seus projetos de Excel. Hoje, exploramos como o IronXL pode criar, ler e exportar arquivos Excel, e vimos como com apenas algumas linhas de código você pode ter controle total sobre esses processos.
Para todas as tarefas programáveis envolvendo documentos Microsoft Excel, o IronXL oferece uma solução abrangente. Você pode realizar cálculos de fórmulas, ordenar cadeias de caracteres ou números, cortar e adicionar dados, buscar e substituir, mesclar e desmesclar células, visualizar dados, e salvar arquivos. Você também pode definir tipos de dados de célula e validar dados de planilha. A capacidade de ler e escrever arquivos CSV permite a interação com dados do Excel.
Recursos avançados adicionais incluem:
IronXL custa $999 no lançamento, mas os clientes podem optar por pagar uma taxa de associação anual para melhorias e suporte ao produto. O IronXL cobra uma taxa de segurança adicional que permite redistribuição irrestrita. Visite esta página de licenciamento para saber mais sobre os detalhes de preços.
Para startups, o IronXL oferece licenças de desenvolvedor que permitem avaliar a biblioteca sem restrições. O modelo de licenciamento é transparente, sem taxas ocultas, e você pode começar com uma única licença de desenvolvedor e atualizar à medida que sua equipe cresce. Confira os guias de solução de problemas para aplicar licenças em diferentes cenários de implantação.
Seja você estiver construindo uma aplicação Blazor, implantando no AWS Lambda, trabalhando com .NET MAUI ou criando aplicações web ASP.NET, o IronXL fornece a flexibilidade e desempenho necessários para implementar funcionalidades de Excel rapidamente, sem a sobrecarga das dependências do Microsoft Office.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronXL faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
A API do Excel que você precisa, sem as complicações do Office Interop.
