Exportar DataGridView para Excel em C# com IronXL

Por que a exportação de DataGridView para o Excel é essencial?

Os controles DataGridView são fundamentais para os aplicativos Windows Forms, exibindo dados tabulares com os quais os usuários interagem diariamente. Exportar esses dados para Excel permite que os usuários apliquem as poderosas ferramentas de análise do Excel, criem apresentações e compartilhem dados com colegas que podem não ter acesso ao aplicativo. Esta funcionalidade de exportação para Excel em C# é crucial para fluxos de trabalho de relatórios empresariais e análise de dados.

Os métodos tradicionais de exportação usando Microsoft.Office.Interop.Excel exigem que o Excel esteja instalado em todas as máquinas que executam o aplicativo. Isso cria desafios de implantação, especialmente em ambientes de servidor ou ao distribuir aplicativos para usuários sem licenças do Office. Além disso, abordagens de Interop podem sofrer com vazamentos de memória e problemas de limpeza de objetos COM se não forem manuseadas com cuidado. Esses desafios tornam-se particularmente agudos quando se implanta no AWS Lambda ou em outras plataformas serverless onde a instalação do Office não é viável.

Aplicativos modernos .NET exigem soluções mais flexíveis. IronXL enfrenta esses desafios fornecendo uma biblioteca independente que gera arquivos Excel sem nenhuma dependência do Microsoft Office. Essa abordagem garante funcionalidade consistente em ambientes de desenvolvimento, teste e produção, enquanto suporta a implantação em contêineres e plataformas em nuvem.

Diagrama de suporte multiplataforma mostrando a compatibilidade do .NET em várias versões (9, 8, 7, 6, Core, Standard, Framework) com ícones para diversas plataformas, incluindo Windows, Linux, Mac, Docker, Azure e AWS.

Como Instalar o IronXL em Seu Projeto C#?

Abra o Console do Gerenciador de Pacotes no Visual Studio e execute o seguinte comando, ou use o .NET CLI:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Saída do terminal mostrando a instalação bem-sucedida do pacote NuGet IronXL.Excel e suas dependências em um projeto C#.

Para obter opções detalhadas de instalação, consulte o guia de instalação do IronXL no NuGet ou pesquise o pacote diretamente no NuGet . Após a instalação, adicione using IronXL; aos arquivos do seu projeto C# para acessar os recursos de exportação para Excel da biblioteca. Ao implantar em ambientes de produção, aplique sua chave de licença para habilitar todos os recursos. Você pode obter uma licença de avaliação gratuita para avaliar o IronXL antes de comprar.

using IronXL;
using System.Data;
using System.Windows.Forms;

// Create a DataTable with sample product data
var dt = new DataTable();
dt.Columns.Add("Product ID", typeof(int));
dt.Columns.Add("Product Name", typeof(string));
dt.Columns.Add("Category", typeof(string));
dt.Columns.Add("Price", typeof(decimal));
dt.Columns.Add("Stock", typeof(int));

dt.Rows.Add(1001, "Laptop Pro", "Electronics", 1299.99m, 15);
dt.Rows.Add(1002, "Wireless Mouse", "Accessories", 29.99m, 50);
dt.Rows.Add(1003, "USB-C Cable", "Accessories", 19.99m, 100);
dt.Rows.Add(1004, "Monitor 27\"", "Electronics", 399.99m, 8);
dt.Rows.Add(1005, "Keyboard Mechanical", "Accessories", 89.99m, 25);

// Bind to DataGridView
var dataGridView1 = new DataGridView();
dataGridView1.DataSource = dt;

// Create new Excel workbook
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Export column headers
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.SetCellValue(0, colIndex, dataGridView1.Columns[colIndex].HeaderText);
}

// Export data rows
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            if (cellValue is decimal or double or int)
                worksheet.SetCellValue(rowIndex + 1, colIndex, Convert.ToDouble(cellValue));
            else
                worksheet.SetCellValue(rowIndex + 1, colIndex, cellValue?.ToString() ?? string.Empty);
        }
    }
}

// Save the Excel file
workbook.SaveAs("DataGridViewExport.xlsx");
Console.WriteLine("Export completed successfully!");

using IronXL;
using System.Data;
using System.Windows.Forms;

// Create a DataTable with sample product data
var dt = new DataTable();
dt.Columns.Add("Product ID", typeof(int));
dt.Columns.Add("Product Name", typeof(string));
dt.Columns.Add("Category", typeof(string));
dt.Columns.Add("Price", typeof(decimal));
dt.Columns.Add("Stock", typeof(int));

dt.Rows.Add(1001, "Laptop Pro", "Electronics", 1299.99m, 15);
dt.Rows.Add(1002, "Wireless Mouse", "Accessories", 29.99m, 50);
dt.Rows.Add(1003, "USB-C Cable", "Accessories", 19.99m, 100);
dt.Rows.Add(1004, "Monitor 27\"", "Electronics", 399.99m, 8);
dt.Rows.Add(1005, "Keyboard Mechanical", "Accessories", 89.99m, 25);

// Bind to DataGridView
var dataGridView1 = new DataGridView();
dataGridView1.DataSource = dt;

// Create new Excel workbook
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Export column headers
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.SetCellValue(0, colIndex, dataGridView1.Columns[colIndex].HeaderText);
}

// Export data rows
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            if (cellValue is decimal or double or int)
                worksheet.SetCellValue(rowIndex + 1, colIndex, Convert.ToDouble(cellValue));
            else
                worksheet.SetCellValue(rowIndex + 1, colIndex, cellValue?.ToString() ?? string.Empty);
        }
    }
}

// Save the Excel file
workbook.SaveAs("DataGridViewExport.xlsx");
Console.WriteLine("Export completed successfully!");

Imports IronXL
Imports System.Data
Imports System.Windows.Forms

' Create a DataTable with sample product data
Dim dt As New DataTable()
dt.Columns.Add("Product ID", GetType(Integer))
dt.Columns.Add("Product Name", GetType(String))
dt.Columns.Add("Category", GetType(String))
dt.Columns.Add("Price", GetType(Decimal))
dt.Columns.Add("Stock", GetType(Integer))

dt.Rows.Add(1001, "Laptop Pro", "Electronics", 1299.99D, 15)
dt.Rows.Add(1002, "Wireless Mouse", "Accessories", 29.99D, 50)
dt.Rows.Add(1003, "USB-C Cable", "Accessories", 19.99D, 100)
dt.Rows.Add(1004, "Monitor 27""", "Electronics", 399.99D, 8)
dt.Rows.Add(1005, "Keyboard Mechanical", "Accessories", 89.99D, 25)

' Bind to DataGridView
Dim dataGridView1 As New DataGridView()
dataGridView1.DataSource = dt

' Create new Excel workbook
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Export column headers
For colIndex As Integer = 0 To dataGridView1.Columns.Count - 1
    worksheet.SetCellValue(0, colIndex, dataGridView1.Columns(colIndex).HeaderText)
Next

' Export data rows
For rowIndex As Integer = 0 To dataGridView1.Rows.Count - 1
    If Not dataGridView1.Rows(rowIndex).IsNewRow Then
        For colIndex As Integer = 0 To dataGridView1.Columns.Count - 1
            Dim cellValue = dataGridView1.Rows(rowIndex).Cells(colIndex).Value
            If TypeOf cellValue Is Decimal OrElse TypeOf cellValue Is Double OrElse TypeOf cellValue Is Integer Then
                worksheet.SetCellValue(rowIndex + 1, colIndex, Convert.ToDouble(cellValue))
            Else
                worksheet.SetCellValue(rowIndex + 1, colIndex, If(cellValue?.ToString(), String.Empty))
            End If
        Next
    End If
Next

' Save the Excel file
workbook.SaveAs("DataGridViewExport.xlsx")
Console.WriteLine("Export completed successfully!")

Como Você Adiciona Formatação Profissional às Exportações do Excel?

Exportações profissionais do Excel geralmente requerem formatação para melhorar a legibilidade. IronXL fornece capacidades de estilo, incluindo personalização de fontes, cores de fundo, bordas e alinhamento. O exemplo abaixo adiciona formatação de cabeçalho e cores de linhas alternadas:

using IronXL;
using System.Data;
using System.Windows.Forms;

// Assume dataGridView1 is already populated with data
var dataGridView1 = new DataGridView();

// (populate dataGridView1 with data as shown in the previous example)

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Set column headers with formatting
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    var headerCell = worksheet.GetCellAt(0, colIndex);
    headerCell.Value = dataGridView1.Columns[colIndex].HeaderText;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
    headerCell.Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;
}

// Export data with alternating row colors
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            var excelCell = worksheet.GetCellAt(rowIndex + 1, colIndex);

            if (cellValue != null)
                excelCell.Value = cellValue.ToString();

            // Apply alternating row background
            if (rowIndex % 2 == 0)
                excelCell.Style.BackgroundColor = "#F2F2F2";
        }
    }
}

// Auto-fit columns
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.AutoSizeColumn(colIndex);
}

workbook.SaveAs("FormattedExport.xlsx");
Console.WriteLine("Formatted export completed successfully!");

using IronXL;
using System.Data;
using System.Windows.Forms;

// Assume dataGridView1 is already populated with data
var dataGridView1 = new DataGridView();

// (populate dataGridView1 with data as shown in the previous example)

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// Set column headers with formatting
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    var headerCell = worksheet.GetCellAt(0, colIndex);
    headerCell.Value = dataGridView1.Columns[colIndex].HeaderText;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
    headerCell.Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;
}

// Export data with alternating row colors
for (int rowIndex = 0; rowIndex < dataGridView1.Rows.Count; rowIndex++)
{
    if (!dataGridView1.Rows[rowIndex].IsNewRow)
    {
        for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
        {
            var cellValue = dataGridView1.Rows[rowIndex].Cells[colIndex].Value;
            var excelCell = worksheet.GetCellAt(rowIndex + 1, colIndex);

            if (cellValue != null)
                excelCell.Value = cellValue.ToString();

            // Apply alternating row background
            if (rowIndex % 2 == 0)
                excelCell.Style.BackgroundColor = "#F2F2F2";
        }
    }
}

// Auto-fit columns
for (int colIndex = 0; colIndex < dataGridView1.Columns.Count; colIndex++)
{
    worksheet.AutoSizeColumn(colIndex);
}

workbook.SaveAs("FormattedExport.xlsx");
Console.WriteLine("Formatted export completed successfully!");

Imports IronXL
Imports System.Data
Imports System.Windows.Forms

' Assume dataGridView1 is already populated with data
Dim dataGridView1 As New DataGridView()

' (populate dataGridView1 with data as shown in the previous example)

Dim workbook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet = workbook.DefaultWorkSheet

' Set column headers with formatting
For colIndex As Integer = 0 To dataGridView1.Columns.Count - 1
    Dim headerCell = worksheet.GetCellAt(0, colIndex)
    headerCell.Value = dataGridView1.Columns(colIndex).HeaderText
    headerCell.Style.Font.Bold = True
    headerCell.Style.BackgroundColor = "#4472C4"
    headerCell.Style.Font.Color = "#FFFFFF"
    headerCell.Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center
Next

' Export data with alternating row colors
For rowIndex As Integer = 0 To dataGridView1.Rows.Count - 1
    If Not dataGridView1.Rows(rowIndex).IsNewRow Then
        For colIndex As Integer = 0 To dataGridView1.Columns.Count - 1
            Dim cellValue = dataGridView1.Rows(rowIndex).Cells(colIndex).Value
            Dim excelCell = worksheet.GetCellAt(rowIndex + 1, colIndex)

            If cellValue IsNot Nothing Then
                excelCell.Value = cellValue.ToString()
            End If

            ' Apply alternating row background
            If rowIndex Mod 2 = 0 Then
                excelCell.Style.BackgroundColor = "#F2F2F2"
            End If
        Next
    End If
Next

' Auto-fit columns
For colIndex As Integer = 0 To dataGridView1.Columns.Count - 1
    worksheet.AutoSizeColumn(colIndex)
Next

workbook.SaveAs("FormattedExport.xlsx")
Console.WriteLine("Formatted export completed successfully!")

Esta versão aprimorada aplica formatação profissional ao arquivo Excel exportado. Os cabeçalhos recebem texto em negrito com fundo azul e cor de fonte branca, criando uma distinção visual clara das linhas de dados. O código implementa cores de linhas alternadas usando uma operação de módulo, melhorando a legibilidade para grandes conjuntos de dados. Você pode personalizar ainda mais a aparência usando o guia de formatação de células do IronXL ou aplicar a funcionalidade de mesclagem de células para abranger colunas de cabeçalho.

O método AutoSizeColumn ajusta a largura das colunas para se adequar ao conteúdo, eliminando o ajuste manual após a exportação. Essas opções de formatação transformam uma exportação de dados básica em um documento pronto para apresentação que pode ser compartilhado imediatamente pelos usuários. Veja como escrever arquivos do Excel com o IronXL para obter mais informações sobre formatação e padrões de escrita de dados.

Como Você Exporta para Múltiplos Formatos e Adiciona Fórmulas?

IronXL vai além da exportação básica do Excel, oferecendo recursos como suporte a fórmulas, múltiplas planilhas e formatos de saída alternativos. O exemplo a seguir demonstra essas capacidades:

using IronXL;

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// (populate worksheet with DataGridView data as shown above)
int dataRowCount = 5; // Replace with actual dataGridView1.Rows.Count

// Add a SUM formula to calculate the total price column
worksheet.SetCellValue(dataRowCount + 2, 3, $"=SUM(D2:D{dataRowCount + 1})");

// Create a summary worksheet
var summarySheet = workbook.CreateWorkSheet("Summary");
summarySheet.SetCellValue(0, 0, "Total Products");
summarySheet.SetCellValue(0, 1, dataRowCount);

// Save in multiple formats
workbook.SaveAs("export.xlsx");
workbook.SaveAsCsv("export.csv");
workbook.SaveAsJson("export.json");
workbook.SaveAsXml("export.xml");

Console.WriteLine("Multi-format export completed!");

using IronXL;

var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var worksheet = workbook.DefaultWorkSheet;

// (populate worksheet with DataGridView data as shown above)
int dataRowCount = 5; // Replace with actual dataGridView1.Rows.Count

// Add a SUM formula to calculate the total price column
worksheet.SetCellValue(dataRowCount + 2, 3, $"=SUM(D2:D{dataRowCount + 1})");

// Create a summary worksheet
var summarySheet = workbook.CreateWorkSheet("Summary");
summarySheet.SetCellValue(0, 0, "Total Products");
summarySheet.SetCellValue(0, 1, dataRowCount);

// Save in multiple formats
workbook.SaveAs("export.xlsx");
workbook.SaveAsCsv("export.csv");
workbook.SaveAsJson("export.json");
workbook.SaveAsXml("export.xml");

Console.WriteLine("Multi-format export completed!");

Imports IronXL

Dim workbook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim worksheet = workbook.DefaultWorkSheet

' (populate worksheet with DataGridView data as shown above)
Dim dataRowCount As Integer = 5 ' Replace with actual dataGridView1.Rows.Count

' Add a SUM formula to calculate the total price column
worksheet.SetCellValue(dataRowCount + 2, 3, $"=SUM(D2:D{dataRowCount + 1})")

' Create a summary worksheet
Dim summarySheet = workbook.CreateWorkSheet("Summary")
summarySheet.SetCellValue(0, 0, "Total Products")
summarySheet.SetCellValue(0, 1, dataRowCount)

' Save in multiple formats
workbook.SaveAs("export.xlsx")
workbook.SaveAsCsv("export.csv")
workbook.SaveAsJson("export.json")
workbook.SaveAsXml("export.xml")

Console.WriteLine("Multi-format export completed!")

IronXL suporta fórmulas do Excel, permitindo que você adicione cálculos diretamente aos arquivos exportados. O exemplo acima adiciona uma fórmula SUM para calcular automaticamente os totais das colunas. Criar múltiplas planilhas ajuda a organizar exportações complexas, como separar dados detalhados de informações de resumo. Visite o guia prático do IronXL para criar arquivos do Excel e conhecer mais modelos de gerenciamento de planilhas.

A flexibilidade de formato é particularmente valiosa para cenários de integração. Embora o XLSX seja o padrão para arquivos do Excel, a exportação em CSV oferece compatibilidade universal com sistemas de banco de dados e aplicativos mais antigos. Os formatos JSON e XML facilitam a troca de dados com serviços web e APIs. Você também pode abrir pastas de trabalho existentes para adicionar dados exportados a planilhas já existentes, em vez de criar novos arquivos a cada vez.

Como o IronXL simplifica seu fluxo de trabalho de desenvolvimento C#?

A principal vantagem do IronXL é a eliminação de dependências do Microsoft Office. Seu aplicativo funciona de maneira consistente, seja implantado em uma estação de trabalho do desenvolvedor, em uma máquina do cliente ou em um contêiner Docker. Essa independência simplifica a implantação e reduz problemas de suporte relacionados a versões e instalações do Office. O Open XML SDK da Microsoft é outra alternativa sem Office, embora requeira significativamente mais código boilerplate comparado à API de nível superior do IronXL. Para orientações sobre o desenvolvimento de .NET 10 multiplataforma, a documentação do Microsoft .NET cobre alvos de plataforma, modelos de implantação e aspectos específicos do Windows Forms.

O design da API da biblioteca prioriza a simplicidade. Ao contrário da abordagem baseada em COM do Interop, que requer a liberação cuidadosa de objetos, o IronXL usa padrões .NET padrão que parecem naturais para desenvolvedores C#. O suporte multiplataforma significa que a funcionalidade de exportação projetada para Windows Forms pode ser reutilizada em aplicativos ASP.NET Core que rodam em servidores Linux. Para uma visão completa das capacidades disponíveis, visite a página de recursos do IronXL.

Você também pode importar dados do Excel para preencher previamente seu DataGridView antes de exportar, criando fluxos de trabalho de ida e volta onde os usuários carregam dados do Excel, editam-nos na grade e exportam o resultado de volta para o Excel. O guia de leitura de arquivos Excel aborda o processo de importação em detalhes.

Ao trabalhar com dados sensíveis, o IronXL suporta proteção por senha em nível de livro e de planilha. A documentação do IronXL cobre opções de segurança para cenários em que arquivos exportados devem ser protegidos antes da distribuição.

Visão geral dos recursos de uma biblioteca do Excel, mostrando seis categorias principais: Criar, Salvar e Exportar, Editar Pastas de Trabalho, Trabalhar com Dados, Proteger suas Pastas de Trabalho e Editar opções de layout.

IronXL.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXL.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Imports IronXL

IronXL.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Por que você deve escolher o IronXL para exportações de Excel em C#?

Exportar dados para o Excel torna-se simples com o IronXL. A biblioteca elimina as complexidades tradicionais do Interop enquanto oferece capacidades de formatação profissional e múltiplos formatos de exportação. Sua arquitetura amigável a contêineres, dependências mínimas e suporte multiplataforma a tornam ideal para fluxos de trabalho modernos DevOps.

A página inicial do IronXL é o ponto de partida para explorar a biblioteca completa. Seja construindo microsserviços, implantando em clusters Kubernetes ou executando funções sem servidor, o IronXL se integra de forma limpa em pipelines CI/CD. O guia prático de exportação para Excel fornece modelos adicionais para diferentes cenários de exportação, e o guia para abrir pastas de trabalho aborda a leitura e a modificação de arquivos existentes.

Comece com uma licença de teste gratuita para explorar o conjunto completo de recursos. Os tutoriais e exemplos de código do IronXL ajudam você a implementar soluções prontas para produção rapidamente. Escolha entre opções de licenciamento flexíveis que atendem às suas necessidades de implantação, desde licenças para desenvolvedores individuais até implantações empresariais ilimitadas. Para qualquer dúvida sobre começos, o hub de documentação do IronXL fornece referências de API, exemplos de código e orientações para solução de problemas.