How to Create an Excel File in C# (.NET Tutorial)

Características do IronXL

Suporte humano direto da nossa equipe de desenvolvimento .NET

• Instalação rápida com o Microsoft Visual Studio
• GRATUITO para desenvolvimento. Licenças de $999

Como posso criar e salvar um arquivo do Excel rapidamente?

Instale o IronXL via NuGet ou baixe a DLL diretamente . A classe WorkBook é o ponto de entrada para todas as operações do Excel, e a classe WorkSheet expõe métodos para manipulação de planilhas individuais. O detalhamento passo a passo completo começa no Passo 1 abaixo.

Como adiciono uma planilha à minha pasta de trabalho?

Adicione planilhas através de CreateWorkSheet:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-4.cs

workSheet["A1"].Value = "January";
workSheet["B1"].Value = "February";
workSheet["C1"].Value = "March";
workSheet["D1"].Value = "April";
workSheet["E1"].Value = "May";
workSheet["F1"].Value = "June";
workSheet["G1"].Value = "July";
workSheet["H1"].Value = "August";
workSheet["I1"].Value = "September";
workSheet["J1"].Value = "October";
workSheet["K1"].Value = "November";
workSheet["L1"].Value = "December";

workSheet("A1").Value = "January"
workSheet("B1").Value = "February"
workSheet("C1").Value = "March"
workSheet("D1").Value = "April"
workSheet("E1").Value = "May"
workSheet("F1").Value = "June"
workSheet("G1").Value = "July"
workSheet("H1").Value = "August"
workSheet("I1").Value = "September"
workSheet("J1").Value = "October"
workSheet("K1").Value = "November"
workSheet("L1").Value = "December"

Um caderno de exercícios contém uma ou mais folhas de exercícios. Cada planilha consiste em linhas e colunas, com células em suas interseções. Use o método CreateWorkSheet para adicionar novas planilhas ao seu workbook.

• WorkBook.CreateWorkSheet(String): Adiciona uma nova planilha com o nome da aba especificado
• WorkSheet: Recupera uma planilha existente pelo nome
• Os nomes das planilhas devem ser únicos dentro de uma pasta de trabalho.

Como posso definir os valores das células manualmente?

O acesso às células usa as mesmas strings de endereço no estilo A1 que você vê no Excel:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-5.cs

Random r = new Random();
for (int i = 2 ; i <= 11 ; i++)
{
    workSheet["A" + i].Value = r.Next(1, 1000);
    workSheet["B" + i].Value = r.Next(1000, 2000);
    workSheet["C" + i].Value = r.Next(2000, 3000);
    workSheet["D" + i].Value = r.Next(3000, 4000);
    workSheet["E" + i].Value = r.Next(4000, 5000);
    workSheet["F" + i].Value = r.Next(5000, 6000);
    workSheet["G" + i].Value = r.Next(6000, 7000);
    workSheet["H" + i].Value = r.Next(7000, 8000);
    workSheet["I" + i].Value = r.Next(8000, 9000);
    workSheet["J" + i].Value = r.Next(9000, 10000);
    workSheet["K" + i].Value = r.Next(10000, 11000);
    workSheet["L" + i].Value = r.Next(11000, 12000);
}

Dim r As New Random()
For i As Integer = 2 To 11
	workSheet("A" & i).Value = r.Next(1, 1000)
	workSheet("B" & i).Value = r.Next(1000, 2000)
	workSheet("C" & i).Value = r.Next(2000, 3000)
	workSheet("D" & i).Value = r.Next(3000, 4000)
	workSheet("E" & i).Value = r.Next(4000, 5000)
	workSheet("F" & i).Value = r.Next(5000, 6000)
	workSheet("G" & i).Value = r.Next(6000, 7000)
	workSheet("H" & i).Value = r.Next(7000, 8000)
	workSheet("I" & i).Value = r.Next(8000, 9000)
	workSheet("J" & i).Value = r.Next(9000, 10000)
	workSheet("K" & i).Value = r.Next(10000, 11000)
	workSheet("L" & i).Value = r.Next(11000, 12000)
Next i

A propriedade Value aceita vários tipos de dados, incluindo strings, números, datas, e booleanos. O IronXL formata automaticamente as células com base no tipo de dados.

Como faço para definir valores de células dinamicamente?

Quando a contagem de linhas é conhecida em tempo de execução, a interpolação de strings torna o corpo do loop fácil de ler:

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

' Initialize random number generator for sample data
Dim r As New Random()

' Populate cells with random budget data for each month
For i As Integer = 2 To 11
	' Set different budget categories with increasing ranges
	workSheet($"A{i}").Value = r.Next(1, 1000) ' Office Supplies
	workSheet($"B{i}").Value = r.Next(1000, 2000) ' Utilities
	workSheet($"C{i}").Value = r.Next(2000, 3000) ' Rent
	workSheet($"D{i}").Value = r.Next(3000, 4000) ' Salaries
	workSheet($"E{i}").Value = r.Next(4000, 5000) ' Marketing
	workSheet($"F{i}").Value = r.Next(5000, 6000) ' IT Services
	workSheet($"G{i}").Value = r.Next(6000, 7000) ' Travel
	workSheet($"H{i}").Value = r.Next(7000, 8000) ' Training
	workSheet($"I{i}").Value = r.Next(8000, 9000) ' Insurance
	workSheet($"J{i}").Value = r.Next(9000, 10000) ' Equipment
	workSheet($"K{i}").Value = r.Next(10000, 11000) ' Research
	workSheet($"L{i}").Value = r.Next(11000, 12000) ' Misc
Next i

' Alternative: Set range of cells with same value
workSheet("A13:L13").Value = 0 ' Initialize totals row

A interpolação de strings ($"...") facilita o referenciamento dinâmico de células. O indexador Item suporta células individuais e intervalos.

Como faço para preencher uma planilha do Excel a partir de um banco de dados?

Carregar dados de bancos de dados para o Excel é um requisito comum:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-7.cs

workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

Este exemplo demonstra como ler dados do Excel a partir de bancos de dados, aplicar formatação e usar fórmulas para cálculos. A propriedade NumberFormat permite formatação de números personalizados, assim como no Excel.

Como posso definir cores de fundo no Excel?

Fundos, cores de linha alternada e sobreposição de cores de fonte passam todos pelo objeto Style em uma célula ou intervalo:

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

' Set header row background to light gray using hex color
workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

' Apply different colors for data categorization
workSheet("A2:A11").Style.SetBackgroundColor("#E7F3FF") ' Light blue for January
workSheet("B2:B11").Style.SetBackgroundColor("#FFF2CC") ' Light yellow for February

' Highlight important cells with bold colors
workSheet("L12").Style.SetBackgroundColor("#FF0000") ' Red for totals
workSheet("L12").Style.Font.FontColor = "#FFFFFF" ' White text

' Create alternating row colors for better readability
For row As Integer = 2 To 11
	If row Mod 2 = 0 Then
		workSheet($"A{row}:L{row}").Style.SetBackgroundColor("#F2F2F2")
	End If
Next row

O método SetBackgroundColor aceita códigos de cores hexadecimais. Combine cores de fundo com Font.FontColor para manter o contraste legível em preenchimentos mais escuros.

Como criar bordas no Excel?

As fronteiras ajudam a definir regiões de dados e a melhorar a estrutura:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-9.cs

// Use IronXL built-in aggregations
decimal sum = workSheet["A2:A11"].Sum();
decimal avg = workSheet["B2:B11"].Avg();
decimal max = workSheet["C2:C11"].Max();
decimal min = workSheet["D2:D11"].Min();

// Assign value to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;

' Use IronXL built-in aggregations
Dim sum As Decimal = workSheet("A2:A11").Sum()
Dim avg As Decimal = workSheet("B2:B11").Avg()
Dim max As Decimal = workSheet("C2:C11").Max()
Dim min As Decimal = workSheet("D2:D11").Min()

' Assign value to cells
workSheet("A12").Value = sum
workSheet("B12").Value = avg
workSheet("C12").Value = max
workSheet("D12").Value = min

O IronXL suporta vários tipos de borda, incluindo fina, média, grossa, dupla, pontilhada e tracejada. Cada lado da borda pode ser estilizado independentemente.

Como posso configurar as propriedades da planilha?

Proteja as planilhas e controle as opções de visualização:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-11.cs

workSheet.SetPrintArea("A1:L12");
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape;
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4;

workSheet.SetPrintArea("A1:L12")
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4

A proteção da planilha impede modificações acidentais, enquanto o congelamento de painéis mantém linhas ou colunas importantes visíveis durante a rolagem.

Figura 7 - A linha de cabeçalho congelada permanece visível enquanto rola

Figura 8 - A proteção por senha impede edições não autorizadas

Como configuro as definições de página e impressão?

As opções de layout de impressão (orientação, tamanho do papel, margens, escala, cabeçalhos, rodapés) são todas expostas através de WorkSheet.PrintSetup:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-12.cs

workBook.SaveAs("Budget.xlsx");

workBook.SaveAs("Budget.xlsx")

A classe IPrintSetup fornece opções de configuração de impressão abrangentes correspondentes às configurações de impressão do Excel.

Figura 9 - Visualização de impressão com orientação paisagem e margens personalizadas

Quanto tempo leva realmente a geração?

Realizei um benchmark de geração em uma máquina com Windows 11 (.NET 9.0.7) para obter números concretos para um livro do tamanho que a maioria dos exportações em produção acabam. O harness constrói um XLSX de 10.000 linhas e três colunas na memória e o escreve no disco em uma única chamada SaveAs, tanto a frio quanto a quente. O projeto completo está na amostra CreateExcelBenchmark abaixo. Três lançamentos de processo separados chegaram aqui aproximadamente:

O número a frio é dominado pelo carregamento de assembly do IronXL e pelo aquecimento do JIT. Uma vez que o processo está aquecido, a geração cai para a faixa de médio-300 ms com alguma variação de execução para execução devido à atividade de fundo. Para livros de trabalho substancialmente maiores (centenas de milhares de linhas, várias planilhas, estilo pesado), escrevo todo o livro de trabalho na memória e chamo SaveAs exatamente uma vez no final. A causa única mais comum de "por que minha exportação é tão lenta?" que vemos é chamar SaveAs repetidamente dentro de um loop enquanto o livro de trabalho está crescendo: cada salvamento serializa o estado atual inteiro, então o custo sobe a cada iteração.

Esquecendo FormatString em datas e moedas

A armadilha de formatação que vejo mais: definir .Value para um DateTime, mas esquecer FormatString. A data é armazenada corretamente, mas o Excel a exibe como um número serial bruto (45292 significa 2024-01-01) até que você aplique uma string de formato como "yyyy-MM-dd". A moeda tem o mesmo problema: o número está correto, mas sem "$#,##0.00" ele é exibido como um decimal simples. Agora escrevo o valor e o formato em linhas adjacentes, para que os dois não se separem:

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

Dim dateCell = sheet("A2")
dateCell.Value = DateTime.Today
dateCell.FormatString = "yyyy-MM-dd"

Dim moneyCell = sheet("B2")
moneyCell.Value = 1499.95D
moneyCell.FormatString = "$#,##0.00"

O XLS irá truncar silenciosamente em 65.536 linhas

Isso é mencionado na seção de escolha de formato perto do topo do artigo, mas ganha seu lugar aqui porque o modo de falha é silencioso: ExcelFileFormat.XLS limita-se a 65.536 linhas por planilha, e as linhas além desse limite são descartadas sem exceção ou aviso. A exportação "sucede" e seus dados se vão. Escolha XLSX para qualquer coisa com muitos dados, a menos que um sistema downstream literalmente não possa lê-lo.

"O Excel diz que o arquivo está corrompido"

Se um arquivo gerado se recusar a abrir ou o Excel afirmar que está corrompido, a causa quase sempre é uma de duas coisas. Ou o fluxo de arquivo não foi descartado adequadamente, então os bytes no disco estão truncados; ou você escreveu para um caminho que ainda estava bloqueado por uma execução anterior, e apenas parte dos dados passou. Certifique-se de que SaveAs (ou o fluxo que o envolve) esteja totalmente concluído antes que qualquer outra coisa toque o arquivo, e prefira um bloco using ao redor de qualquer MemoryStream ou FileStream que você envolva um livro de trabalho.

Projeto de exemplo para os números do benchmark

Se você quiser reproduzir os números de tempo de antes, o suporte é um pequeno aplicativo de console .NET 9:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-15.cs

// CreateExcelBenchmark/Program.cs (excerpt)
IronXL.License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY");

var sw = Stopwatch.StartNew();
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("Data");
sheet["A1"].Value = "Id";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Amount";
for (int i = 0; i < 10_000; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = i + 1;
    sheet[$"B{row}"].Value = $"Item {i + 1}";
    sheet[$"C{row}"].Value = (i + 1) * 1.25m;
}
workbook.SaveAs("Generated.xlsx");
sw.Stop();
Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms");

Imports System
Imports System.Diagnostics
Imports IronXL

Module Program
    Sub Main()
        License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY")

        Dim sw As Stopwatch = Stopwatch.StartNew()
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim sheet As WorkSheet = workbook.CreateWorkSheet("Data")
        sheet("A1").Value = "Id"
        sheet("B1").Value = "Name"
        sheet("C1").Value = "Amount"
        For i As Integer = 0 To 9999
            Dim row As Integer = i + 2
            sheet($"A{row}").Value = i + 1
            sheet($"B{row}").Value = $"Item {i + 1}"
            sheet($"C{row}").Value = (i + 1) * 1.25D
        Next
        workbook.SaveAs("Generated.xlsx")
        sw.Stop()
        Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms")
    End Sub
End Module

Execute-o sob dotnet run -c Release e substitua seus próprios números de linhas, números de colunas ou estilos para ver como os números variam com a complexidade do livro de trabalho.