Como abrir um arquivo do Excel no ASP.NET Core

O que é IronXL?

IronXL é uma biblioteca .NET Excel que oferece funcionalidades para trabalhar com documentos Excel sem exigir dependências do Microsoft Excel ou do Office Interop. Ela suporta tanto o .NET Framework quanto o .NET Core, fornecendo capacidades para escrever, manipular e ler arquivos Excel com apenas algumas linhas de código. Para um tutorial detalhado sobre leitura de arquivos Excel, consulte este tutorial de Excel.

A biblioteca IronXL pode ler e escrever documentos Excel, extrair dados deles, manipular os dados e até mesmo criar novos arquivos Excel do zero. IronXL não suporta apenas o formato .XLS, mas também é compatível com .XLSX, que é um formato de arquivo baseado em XML desenvolvido pela Microsoft para representar planilhas.

Pré-requisitos

Antes de mergulhar no código, certifique-se de ter o seguinte:

1. .NET Core 3.1 ou superior instalado.
2. Um IDE adequado para desenvolvimento .NET (Microsoft Visual Studio é recomendado).
3. Compreensão básica de ASP.NET Core e Razor Pages.

Criar um novo Projeto .NET Core

1. Abra o Microsoft Visual Studio e selecione "Criar um novo projeto".
2. Escolha "Aplicativo Web ASP.NET Core" na lista de modelos de projeto e clique em "Avançar".
3. Forneça um nome para o seu projeto, por exemplo, "Open_ExcelFile.NET_Core", selecione um local e clique em "Avançar".
4. Escolha ".NET Core" como o framework de destino e "ASP.NET Core 3.1 ou superior" como a versão. Na seção "Modelo de projeto", selecione "Aplicativo Web" e clique em "Criar".

Criar uma Página Razor

Agora, vamos criar uma Página Razor para escrever o código para abrir o arquivo Excel.

1. Clique com o botão direito no diretório "Pages" no Explorador de Soluções e selecione "Adicionar" > "Página Razor".
2. Digite "ExcelOpener" como o nome da Página e clique em "Adicionar".

Criar uma nova Página Razor

Isso criará dois arquivos: ExcelOpener.cshtml e ExcelOpener.cshtml.cs.

O arquivo ExcelOpener.cshtml contém o markup HTML para a página, e o arquivo ExcelOpener.cshtml.cs contém o código C# para a página.

Lendo Arquivos Excel

Vamos mergulhar no código. A classe fornecida ExcelOpenerModel é um Modelo de Página Razor. Essa classe possui uma propriedade Data, que será usada para armazenar os dados lidos de um arquivo Excel.

public List<List<string>> Data { get; set; }

public ExcelOpenerModel()
{
    Data = new List<List<string>>();
}

public List<List<string>> Data { get; set; }

public ExcelOpenerModel()
{
    Data = new List<List<string>>();
}

Public Property Data() As List(Of List(Of String))

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: public ExcelOpenerModel()
Public Sub New()
	Data = New List(Of List(Of String))()
End Sub

No método OnGet, o IronXL é utilizado para carregar um arquivo Excel e ler os dados da planilha padrão (a primeira folha no livro). Cada linha é representada como uma List<string>, e todas essas listas são então adicionadas à propriedade Data.

public void OnGet()
{
    try
    {
        Data = new List<List<string>>();
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < sheet.RowCount; i++)
        {
            var row = new List<string>();
            for (int j = 0; j < sheet.ColumnCount; j++)
            {
                row.Add(sheet.GetCellAt(i, j).Value.ToString());
            }
            Data.Add(row);
        }
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

public void OnGet()
{
    try
    {
        Data = new List<List<string>>();
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < sheet.RowCount; i++)
        {
            var row = new List<string>();
            for (int j = 0; j < sheet.ColumnCount; j++)
            {
                row.Add(sheet.GetCellAt(i, j).Value.ToString());
            }
            Data.Add(row);
        }
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

Public Sub OnGet()
	Try
		Data = New List(Of List(Of String))()
		' Load your Excel file
		Dim workbook = WorkBook.Load("C:\Users\Administrator\Documents\Loan.xlsx")

		' Select your Worksheet
		Dim sheet As WorkSheet = workbook.DefaultWorkSheet

		For i As Integer = 0 To sheet.RowCount - 1
			Dim row = New List(Of String)()
			For j As Integer = 0 To sheet.ColumnCount - 1
				row.Add(sheet.GetCellAt(i, j).Value.ToString())
			Next j
			Data.Add(row)
		Next i
	Catch ex As Exception
		' Handle exceptions here
		Console.WriteLine(ex.Message)
	End Try
End Sub

Escrevendo Arquivos Excel

O método OnPost na classe ExcelOpenerModel é usado para salvar modificações no arquivo Excel. Primeiro, carrega o arquivo Excel e recupera a planilha padrão. Em seguida, escreve os valores de Data nas células da planilha e salva o livro em um novo arquivo.

public void OnPost()
{
    try
    {
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        var sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < Data.Count; i++)
        {
            for (int j = 0; j < Data[i].Count; j++)
            {
                sheet.SetCellValue(i, j, Data[i][j]);
            }
        }

        // Save the Excel file
        var filename = @"C:\ModifiedData.xlsx";
        workbook.SaveAs(filename);
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

public void OnPost()
{
    try
    {
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        var sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < Data.Count; i++)
        {
            for (int j = 0; j < Data[i].Count; j++)
            {
                sheet.SetCellValue(i, j, Data[i][j]);
            }
        }

        // Save the Excel file
        var filename = @"C:\ModifiedData.xlsx";
        workbook.SaveAs(filename);
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

Public Sub OnPost()
	Try
		' Load your Excel file
		Dim workbook = WorkBook.Load("C:\Users\Administrator\Documents\Loan.xlsx")

		' Select your Worksheet
		Dim sheet = workbook.DefaultWorkSheet

		For i As Integer = 0 To Data.Count - 1
			Dim j As Integer = 0
			Do While j < Data(i).Count
				sheet.SetCellValue(i, j, Data(i)(j))
				j += 1
			Loop
		Next i

		' Save the Excel file
		Dim filename = "C:\ModifiedData.xlsx"
		workbook.SaveAs(filename)
	Catch ex As Exception
		' Handle exceptions here
		Console.WriteLine(ex.Message)
	End Try
End Sub

Formulário HTML para Edição de Dados Excel

No ExcelOpener.cshtml, um formulário é definido para exibir e editar os dados do arquivo Excel. Cada valor de célula é exibido em um campo de entrada de texto. Depois de editar, clicar no botão "Save" enviará o formulário, acionando o método OnPost e salvando as alterações no arquivo Excel.

@page
@model Open_Excel_File_.NET_Core.Pages.ExcelOpenerModel

<form method="post">
    <table class="table table-bordered table-striped">

        @for (int i = 0; i < Model.Data.Count; i++)
        {
            <tr>
                @for (int j = 0; j < Model.Data[i].Count; j++)
                {
                    <td>
                        <input type="text" class="form-control" name="Data[@i][@j]" value="@Model.Data[i][j]" /> 
                    </td>
                }
            </tr>
        }
    </table>

    <input type="submit" class="btn btn-primary" value="Save" /> 
</form>

@page
@model Open_Excel_File_.NET_Core.Pages.ExcelOpenerModel

<form method="post">
    <table class="table table-bordered table-striped">

        @for (int i = 0; i < Model.Data.Count; i++)
        {
            <tr>
                @for (int j = 0; j < Model.Data[i].Count; j++)
                {
                    <td>
                        <input type="text" class="form-control" name="Data[@i][@j]" value="@Model.Data[i][j]" /> 
                    </td>
                }
            </tr>
        }
    </table>

    <input type="submit" class="btn btn-primary" value="Save" /> 
</form>

Navegando para a Página

No _Layout.cshtml, um link para a página é adicionado ao menu de navegação. Ao clicar neste link, você navegará para a página de abertura de Excel.

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-page="/ExcelOpener">ExcelOpener</a>
</li>

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-page="/ExcelOpener">ExcelOpener</a>
</li>

Executando a Aplicação e Explicando o Resultado

Construa a aplicação clicando no botão "Build" no Visual Studio ou usando o atalho Ctrl + Shift + B. Execute a aplicação pressionando F5 ou clicando no botão "Iniciar" no Visual Studio.

Uma vez que a aplicação estiver em execução, navegue para a página "ExcelOpener" clicando no link correspondente na barra de navegação. A página exibirá os dados do Excel em formato tabular.

Você pode modificar os dados na tabela e clicar no botão "Salvar" para salvar as alterações de volta no arquivo Excel.

Exibir dados de Excel na Aplicação Web

Este tutorial demonstrou como abrir um arquivo Excel usando IronXL em uma aplicação ASP.NET Core. IronXL fornece uma maneira simples e conveniente de ler e manipular arquivos Excel. Você pode explorar a documentação do IronXL para funcionalidades e recursos mais avançados.

IronXL oferece um teste gratuito, permitindo que você avalie suas capacidades. Se achar útil para seus projetos, você pode adquirir uma licença a partir de $799.