Como criar uma nova planilha do Excel em C#

Como Começo a Criar Pastas de Trabalho do Excel em C#?

Neste tutorial, vamos aprender a criar uma nova pasta de trabalho usando IronXL em C#. Vamos passar pelas etapas necessárias, desde a configuração do ambiente de desenvolvimento até a escrita de código que gera uma nova pasta de trabalho do Excel. Você descobrirá como criar planilhas programaticamente sem qualquer instalação do Excel na sua máquina.

Ao final deste tutorial, você terá uma compreensão sólida de como aproveitar o IronXL para criar planilhas do Excel programaticamente, permitindo que você integre funcionalidades do Excel em suas aplicações C# com facilidade. Vamos começar!

O que é IronXL?

IronXL é uma biblioteca C# versátil que permite trabalhar com documentos do Excel sem precisar do Microsoft Office Excel Interop ou qualquer Aplicativo Excel. Ele permite que você leia, crie e modifique planilhas facilmente, formate células, adicione fórmulas e trabalhe com formatos de arquivo Excel tanto modernos quanto antigos.

Você pode validar dados, inserir imagens, aplicar formatação condicional e criar gráficos sem precisar do Microsoft Office. Os desenvolvedores podem construir soluções para Excel em tarefas como relatórios financeiros, painéis de dados e gerenciamento de inventário com facilidade usando o IronXL. A biblioteca suporta conversão entre diferentes formatos de planilha incluindo XLSX, XLS, CSV, TSV, JSON e XML.

Vamos começar a criar um arquivo Excel em C#.

Como crio um novo projeto C# para desenvolvimento de Excel?

Abra o Visual Studio e crie um novo projeto de Aplicativo de Console em C#. Nomeie como preferir. Você também pode criar outros tipos de projetos como ASP.NET MVC, Blazor, MAUI, Web Forms, Windows Forms, Web API, etc. Este código funcionará com todos os tipos de projetos. Estou usando uma aplicação console por simplicidade e para torná-la relevante para todos os tipos de projetos. A biblioteca funciona até mesmo em containers Docker e Funções Azure.

Como instalo o pacote IronXL NuGet?

Para instalar o pacote IronXL em seu projeto C#, você pode usar qualquer um dos seguintes métodos. A configuração adequada da chave de licença assegura que suas implantações em produção funcionem sem restrições.

1. Para instalar o IronXL, clique com o botão direito no seu projeto no Solution Explorer, escolha "Gerenciar Pacotes NuGet," procure por IronXL e, em seguida, prossiga com a instalação.

2. Alternativamente, você pode instalar o IronXL via o Console do Gerenciador de Pacotes usando o seguinte comando:

Install-Package IronXl.Excel

Este comando irá baixar, instalar e adicionar uma referência de assembly ao seu projeto. Aguarde o pacote ser baixado e instalado. Uma vez que a instalação estiver completa, você pode começar a usar o IronXL em seu projeto para trabalhar com arquivos Excel programaticamente.

Como importo namespaces necessários?

No topo do seu arquivo C#, adicione o seguinte namespace:

using IronXL;

using IronXL;

Como Criar Um Novo Arquivo Excel Programaticamente?

Agora, vamos escrever o código para criar um arquivo Excel:

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Mr. Author"; // Set the author (optional)

        // Add a blank worksheet named "Sheet1"
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1");

        // Add data to the new worksheet
        workSheet["A1"].Value = "Developer Name";
        workSheet["A2"].Value = "John Grahm";
        workSheet["A3"].Value = "David Smith";
        workSheet["A4"].Value = "Rishi Kelkar";

        // Save the Excel file as "Developers.xlsx"
        workBook.SaveAs("Developers.xlsx");
    }
}

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Mr. Author"; // Set the author (optional)

        // Add a blank worksheet named "Sheet1"
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1");

        // Add data to the new worksheet
        workSheet["A1"].Value = "Developer Name";
        workSheet["A2"].Value = "John Grahm";
        workSheet["A3"].Value = "David Smith";
        workSheet["A4"].Value = "Rishi Kelkar";

        // Save the Excel file as "Developers.xlsx"
        workBook.SaveAs("Developers.xlsx");
    }
}

O código acima demonstra como criar um arquivo Excel programaticamente usando o IronXL em C#. Começa criando um novo workbook Excel (uma nova instância de um arquivo Excel) no formato XLSX, define metadados do autor usando as propriedades de metadados do workbook, adiciona uma planilha Excel em branco chamada "Sheet1" usando o método CreateWorkSheet(), preenche dados nas células A1 a A4, e finalmente salva o workbook como "Developers.xlsx".

O IronXL oferece uma gama de funcionalidades para trabalhar com arquivos Excel, incluindo criação, manipulação e salvamento em vários formatos como XLSX, CSV, TSV, JSON, XML e HTML. Você também pode carregar planilhas existentes para modificá-las ou gerenciar várias planilhas dentro de um único workbook.

A saída é como:

Como Aplicar Formatação e Estilização a Arquivos Excel?

O IronXL permite formatar células, aplicar estilos de fonte, definir cores de fundo e ajustar alinhamentos. Você pode criar planilhas com aparência profissional personalizando a aparência das células. A biblioteca suporta estilo abrangente de células, incluindo bordas, fontes e opções de alinhamento.

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

O código acima demonstra como personalizar a aparência de células específicas em uma planilha Excel usando o IronXL em C#. Primeiro, ele define a cor e padrão de fundo da célula A1 para um tom amarelo claro e torna a fonte em negrito, efetivamente estilizando-a como um cabeçalho.

Em seguida, define um intervalo de células de A1 a A4 e aplica bordas de peso médio nas arestas inferior, esquerda, direita e superior deste intervalo, melhorando sua distinção visual dentro da planilha. Essas opções de estilização permitem que os desenvolvedores criem documentos Excel visualmente atraentes e organizados, adaptados às suas necessidades específicas. Você também pode definir formatos de dados das células para números, datas e moedas.

A saída é como:

Como Adicionar Fórmulas e Cálculos?

Você pode adicionar fórmulas às células programaticamente. IronXL suporta uma ampla gama de funções do Excel e operações matemáticas. A biblioteca pode definir fórmulas e avaliar seus resultados.

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

O código acima ilustra como usar fórmulas e funções no IronXL para calcular o comprimento dos nomes dos desenvolvedores e computar a soma desses comprimentos dentro de uma planilha Excel. Por meio dessa demonstração, os desenvolvedores podem entender como integrar fórmulas e funções dentro do IronXL para realizar cálculos dinâmicos e manipulações dentro de planilhas Excel programaticamente, oferecendo flexibilidade e automação em tarefas de processamento de dados.

Primeiro, um cabeçalho intitulado "Comprimento do Nome" é adicionado à célula B1, com estilo para destacar sua importância. Em seguida, fórmulas são aplicadas às células B2, B3 e B4 para calcular o comprimento do nome de cada desenvolvedor usando a função LEN, referenciando a célula correspondente na coluna A. Isso permite o cálculo automático dos comprimentos dos nomes à medida que os nomes dos desenvolvedores mudam.

Além disso, uma contagem total dos comprimentos dos nomes é computada na célula B5 usando a função SUM, que soma os valores das células B2 a B4. Você também pode usar outras funções agregadas como AVERAGE, MIN e MAX.

Ao incorporar essas fórmulas, a planilha torna-se dinamicamente atualizada. Embora este caso de uso específico possa não ser prático, ele serve como um exemplo de uso das fórmulas do Excel em código.

Quais São Meus Próximos Passos com o IronXL?

Em resumo, este tutorial demonstrou como criar um novo workbook Excel em C# usando IronXL, uma biblioteca robusta que facilita a manipulação de arquivos Excel dentro do ecossistema C#. Com o IronXL, os desenvolvedores podem integrar facilmente a funcionalidade Excel em suas aplicações, desde a configuração do ambiente de desenvolvimento até a geração programática de workbooks Excel. Juntamente com sua capacidade de realizar tarefas como formatação, estilização e aplicação de fórmulas, o IronXL oferece um conjunto de recursos abrangente para gestão eficiente de dados e análise.

Para referências sobre como usar o IronXL, visite a página de documentação. O IronXL também oferece uma coleção de exemplos de código que são úteis para começar. Explore cenários avançados como criação de gráficos, trabalho com intervalos nomeados ou proteção de planilhas.

Os desenvolvedores podem explorar o IronXL através de sua versão de teste gratuita e comprar, assegurando uma transição tranquila da avaliação para a implementação em grande escala. Para mais detalhes sobre licenças perpétuas, visite a página de licença. Considere explorar extensões de licença para recursos adicionais.