Biblioteca .NET Excel (Tutorial para Desenvolvedores)

Por que escolher o IronXL em vez do Microsoft.Office.Interop?

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.

Quais Plataformas e Formatos o IronXL Suporta?

• Compatível tanto com .NET Core quanto com .NET Framework
• Suporta aplicativos Web, Windows Forms e Console
• Funciona com Linux, macOS e Windows
• Oferece acesso rápido e fácil a arquivos Excel
• Lê múltiplos tipos de arquivos Excel: XLSX, CSV, XLS, XLST, TSV, XLSM e mais
• Realiza cálculos em planilhas Excel
• Suporta vários tipos de dados: texto, inteiros, datas, moedas, fórmulas e percentuais
• Trata múltiplos formatos de valores para colunas do Excel

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.

Quais São as Etapas para Criar um Novo Projeto de Console?

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

Qual versão do .NET Framework devo escolher?

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 Funções Azure.

Como Instalo o IronXL Através do Gerenciador de Pacotes NuGet?

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:

Install-Package IronXl.Excel

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.

Qual é o Código Mínimo para Gerar um Novo Workbook do Excel?

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

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

O 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 aba 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
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");

Saída do Excel

Onde Posso Encontrar Mais Exemplos de Criação de Arquivos 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.

Que Código Preciso para Carregar e Modificar Arquivos Excel Existentes?

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

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

Como Acesso Planilhas por Nome ou Índice?

No exemplo anterior, um arquivo Excel existente é carregado usando o método LoadExcel, que toma o nome do arquivo e o caminho 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
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

Saída do console

Quais Opções de Exportação Estão Disponíveis para Arquivos Excel?

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.

Quais Recursos Avançados o IronXL Oferece?

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:

• Formatação condicional para visualização dinâmica de dados
• Proteção por senha para arquivos Excel seguros
• Congelar painéis para melhor navegação
• Adicionar comentários para colaboração
• Agrupar e desagrupar linhas e colunas
• Intervalos nomeados e tabelas nomeadas para fórmulas mais limpas
• Suporte a hiperlinks para planilhas interativas
• Ajustar automaticamente linhas e colunas para visualização ideal

Qual é o Modelo de Preços para Equipes Iniciantes?

O IronXL custa $799 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.