Jak otworzyć plik Excel w ASP .NET Core

Czym jest IronXL?

Biblioteka IronXL for .NET dla programu Excel, która zapewnia funkcjonalność do pracy z dokumentami Excel bez konieczności korzystania z programu Microsoft Excel lub interfejsu Office Interop. Obsługuje zarówno .NET Framework, jak i .NET Core, zapewniając możliwość pisania, manipulowania i odczytywania plików Excel za pomocą zaledwie kilku linii kodu. Szczegółowy samouczek dotyczący odczytu plików Excel można znaleźć w tym samouczku dotyczącym programu Excel.

Biblioteka IronXL może odczytywać i zapisywać dokumenty Excel, wyodrębniać z nich dane, przetwarzać je, a nawet tworzyć nowe pliki Excel od podstaw. IronXL obsługuje nie tylko format .XLS, ale jest również kompatybilny z formatem .XLSX, który jest formatem plików opartym na XML, opracowanym przez firmę Microsoft do przedstawiania arkuszy kalkulacyjnych.

Wymagania wstępne

Zanim zagłębisz się w kod, upewnij się, że masz:

1. Zainstalowany .NET Core 3.1 lub nowszy.
2. Odpowiednie środowisko IDE do programowania w .NET (zalecane jest Microsoft Visual Studio).
3. Podstawowa znajomość ASP.NET Core i Razor Pages.

Utwórz nowy projekt .NET Core

1. Otwórz program Microsoft Visual Studio i wybierz opcję "Utwórz nowy projekt".
2. Wybierz "ASP.NET Core Web App" z listy szablonów projektów i kliknij "Dalej".
3. Nadaj nazwę projektowi, na przykład "Open_ExcelFile.NET_Core", wybierz lokalizację i kliknij "Dalej".
4. Wybierz ".NET Core" jako docelowy framework i "ASP.NET Core 3.1 lub nowszy" jako wersję. W sekcji "Szablon projektu" wybierz "Aplikacja internetowa" i kliknij "Utwórz".

Utwórz stronę Razor

Teraz stwórzmy stronę Razor, aby napisać kod otwierający plik Excel.

1. Kliknij prawym przyciskiem myszy folder "Pages" w Eksploratorze rozwiązań i wybierz "Dodaj" > "Strona Razor".

2. Wpisz "ExcelOpener" jako nazwę strony i kliknij "Dodaj".

   Utwórz nową stronę Razor

Spowoduje to utworzenie dwóch plików: ExcelOpener.cshtml i ExcelOpener.cshtml.cs.

Plik ExcelOpener.cshtml zawiera znaczniki HTML dla strony, a plik ExcelOpener.cshtml.cs zawiera kod C# dla tej strony.

Odczytywanie plików Excel

Przejdźmy do kodu. Podana klasa ExcelOpenerModel jest modelem strony Razor. Ta klasa posiada właściwość List<List<string>> Data, która będzie służyć do przechowywania danych odczytanych z pliku 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

W metodzie OnGet używa się IronXL do wczytania pliku Excel i odczytania danych z domyślnego arkusza (pierwszego arkusza w skoroszycie). Każdy wiersz jest reprezentowany jako List<string>, a wszystkie te listy są następnie dodawane do właściwości 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

Tworzenie plików Excel

Metoda OnPost w klasie ExcelOpenerModel służy do zapisywania zmian w pliku Excel. Najpierw ładuje plik Excel i pobiera domyślny arkusz. Następnie zapisuje wartości z Data do komórek w arkuszu i zapisuje skoroszyt w nowym pliku.

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

Formularz HTML do edycji danych programu Excel

W pliku ExcelOpener.cshtml zdefiniowano formularz służący do wyświetlania i edycji danych z pliku Excel. Każda wartość komórki jest wyświetlana w polu wprowadzania tekstu. Po edycji kliknięcie przycisku "Zapisz" spowoduje przesłanie formularza, uruchomienie metody OnPost i zapisanie zmian w pliku 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>

Przejście do strony

W pliku _Layout.cshtml do menu nawigacyjnego dodano link do tej strony. Klikając ten link, przejdziesz do strony otwierającej plik 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>

Uruchamianie aplikacji i wyjaśnianie wyników

Skompiluj aplikację, klikając przycisk "Build" w Visual Studio lub używając skrótu Ctrl + Shift + B. Uruchom aplikację, naciskając klawisz F5 lub klikając przycisk "Start" w programie Visual Studio.

Po uruchomieniu aplikacji przejdź do strony "ExcelOpener", klikając odpowiedni link na pasku nawigacyjnym. Strona wyświetli dane z Excela w formacie tabelarycznym.

Możesz zmodyfikować dane w tabeli i kliknąć przycisk "Zapisz", aby zapisać zmiany z powrotem w pliku Excel.

Wyświetlanie danych z Excela w aplikacji internetowej

W tym samouczku pokazano, jak otworzyć plik Excel za pomocą IronXL w aplikacji ASP.NET Core. IronXL zapewnia prosty i wygodny sposób odczytu i edycji plików Excel. Więcej informacji na temat zaawansowanych funkcji i możliwości można znaleźć w dokumentacji IronXL.

IronXL oferuje bezpłatną wersję próbną, która pozwala ocenić jego możliwości. Jeśli uznasz to za przydatne w swoich projektach, możesz nabyć licencję już od $799.