Como importar um arquivo Excel para um GridView em ASP.NET C#

Como Instalar o IronXL para Integração de GridView no Excel?

Antes de escrever qualquer código, você precisa adicionar o IronXL ao seu projeto ASP.NET. O caminho mais rápido é o NuGet, seja pelo Console do Gerenciador de Pacotes do Visual Studio ou pelo CLI do .NET.

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Uma vez instalado, o NuGet adiciona todas as referências necessárias ao seu projeto. Não há drivers externos para instalar, nenhum fornecedor de OLEDB para registrar e nenhuma dependência do Microsoft Office no servidor. A biblioteca é fornecida como um único assembly gerenciado e funciona em Windows, Linux, macOS e ambientes de hospedagem em nuvem, incluindo o Azure App Service.

Após a instalação, adicione os seguintes namespaces a qualquer arquivo code-behind que leia ou escreva dados do Excel:

using IronXL;
using System.Data;
using System.IO;

using IronXL;
using System.Data;
using System.IO;

IronXL suporta ambos os formatos .xls (Excel 97-2003) e .xlsx (Excel 2007+), então você não precisa de tratamento separado para cada tipo de arquivo. A mesma chamada WorkBook.Load lida com qualquer formato inspecionando a assinatura do arquivo automaticamente.

Qual É a Maneira Mais Rápida de Carregar Dados do Excel em um GridView?

O método mais rápido combina WorkBook.Load, sheet.ToDataTable e GridView.DataBind em cerca de quatro linhas de código eficaz. Não é necessária criação manual de colunas nem iteração de linhas para cenários básicos.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

A chamada ToDataTable(true) informa ao IronXL para promover a primeira linha da planilha para nomes de coluna no DataTable resultante. Quando você vincula essa tabela a um GridView com AutoGenerateColumns="true", o ASP.NET cria automaticamente uma coluna por cabeçalho do Excel.

Como Criar uma Página ASP.NET Web Forms para Importar Excel?

Uma página de importação mínima precisa de três controles: um input de upload de arquivo, um botão de envio e o GridView. Adicione a marcação ASPX a seguir dentro do seu elemento <form runat="server">:

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

O atributo CssClass conecta a grade à sua folha de estilo Bootstrap se você estiver usando uma, dando-lhe linhas e bordas estilizadas sem configuração extra.

Não code-behind, trate o evento de clique do botão. O padrão abaixo salva o arquivo enviado em um caminho temporário do servidor, carrega-o com IronXL e vincula o DataTable resultante à grade:

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

Esta implementação segue o estilo de declarações de nível superior para a lógica dentro do manipulador de eventos, mantendo a assinatura de evento requerida do Web Forms. Observe que Directory.CreateDirectory é chamado defensivamente -- se a pasta Uploads já existir, a chamada é um no-op.

Após o usuário selecionar um arquivo .xlsx e clicar no botão de upload, a grade é preenchida com o conteúdo da planilha. Os nomes das colunas vêm da primeira linha do arquivo Excel, e todas as linhas subsequentes se tornam linhas de dados na grade.

string ext = Path.GetExtension(FileUpload1.FileName).ToBaixoerInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

string ext = Path.GetExtension(FileUpload1.FileName).ToBaixoerInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

Como Você Acessa Planilhas e Intervalos de Células Específicos?

Quando um livro de Excel contém várias folhas, você precisa direcionar uma específica pelo nome em vez de confiar em DefaultWorkSheet. IronXL fornece um método GetWorkSheet que aceita o nome da aba da folha como uma string.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

O método ToDataSet é útil quando sua aplicação precisa exibir dados de várias folhas ou deixar o usuário escolher qual folha visualizar. Cada DataTable no DataSet retornado corresponde a uma planilha do Excel, e o nome da tabela corresponde ao nome da aba da folha.

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

Como Você Compara Métodos de Importação para Vinculação de GridView no Excel?

Diferentes abordagens para vinculação Excel-para-GridView têm compensações distintas. A tabela abaixo resume os métodos mais comuns para que você possa escolher o certo para o seu cenário.

IronXL cobre ambos os formatos XLS legados e XLSX modernos, não requer instalação de driver do lado do servidor e oferece a menor complexidade de código das opções listadas. Para equipes que já utilizam outros produtos da Iron Software, como IronPDF ou IronOCR, uma única licença da Iron Software cobre todo o suite.

Como Você Exporta Dados do GridView de Volta para o Excel?

Completar a viagem de ida e volta - do Excel para uma grade e de volta para o Excel - é igualmente conciso com IronXL. Este padrão é útil para botões 'baixar como Excel' que permitem que os usuários exportem o que está sendo exibido atualmente na grade.

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

A chamada Response.TransmitFile transmite o arquivo salvo para o navegador, acionando um diálogo de download. O cabeçalho Content-Disposition: attachment garante que os navegadores façam o download em vez de tentar exibir o arquivo inline.

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

Quais são os seus próximos passos?

Agora você tem um pipeline completo e sem driver para importar arquivos Excel em um GridView ASP.NET e exportar dados do GridView de volta para Excel usando IronXL. Aqui está o que explorar a seguir para construir sobre esta base:

• Leia a documentação do IronXL para a referência completa da API, incluindo avaliação de fórmulas, operações de intervalos de células e criação de gráficos.
• Explore a biblioteca de exemplos de código do IronXL para trechos prontos para execução sobre importação de CSV, livros protegidos por senha, formatação condicional e mais.
• Tente o tutorial Excel para DataTable se você quiser uma cobertura mais profunda de mapeamento de coluna digitada e manuseio de nulos.
• Verifique a página de licenciamento do IronXL para revisar as opções desde licenças de desenvolvimento até redistribuição OEM.
• Revise o guia de leitura de Excel .NET da Iron Software para entender navegação em livros e planilhas em detalhes.
• Compare o IronXL com alternativas usando a comparação de bibliotecas de Excel C# para uma análise recurso por recurso contra OLEDB, EPPlus e o SDK Open XML.

Para aplicações .NET Core e ASP.NET Core, a mesma API do IronXL funciona em Razor Pages e controladores MVC. O guia do IronXL ASP.NET Core aborda as diferenças no manuseio de uploads de arquivos e padrões de injeção de dependência.

Se você está integrando o IronXL junto com geração de documentos, o guia de integração do IronPDF mostra como exportar dados de GridView para um relatório em PDF além de Excel, útil para aplicações que precisam de ambos os formatos.

Comece com o teste gratuito do IronXL para testar todos os recursos em seu projeto antes de comprar. Nenhum cartão de crédito é necessário para a licença de teste.