Jak importować Excel do GridView w ASP.NET C#

Jak zainstalować IronXL do integracji GridView w Excelu?

Przed napisaniem jakiegokolwiek kodu należy dodać IronXL do projektu ASP.NET. Najszybszym sposobem jest NuGet, dostępny albo z konsoli menedżera pakietów Visual Studio, albo z interfejsu CLI .NET.

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Po zainstalowaniu NuGet dodaje wszystkie wymagańe odniesienia do projektu. Nie ma potrzeby instalowania żadnych zewnętrznych sterowników, rejestrowania dostawców OLEDB ani korzystania z pakietu Microsoft Office na serwerze. Biblioteka jest dostarczana jako pojedynczy zestaw zarządzany i działa w systemach Windows, Linux, macOS oraz w środowiskach hostingu w chmurze, w tym w usłudze Azure App Service.

Po instalacji dodaj następujące przestrzenie nazw do dowolnego pliku kodowego, który odczytuje lub zapisuje dane programu Excel:

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

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

Imports IronXL
Imports System.Data
Imports System.IO

IronXL obsługuje zarówno format .xls (Excel 97-2003), jak i .xlsx (Excel 2007+), więc nie ma potrzeby osobnego traktowania każdego typu pliku. To samo wywołanie WorkBook.Load obsługuje oba formaty, automatycznie sprawdzając sygnaturę pliku.

Jaki jest najszybszy sposób na załadowanie danych z Excela do GridView?

Najszybsza metoda łączy WorkBook.Load, sheet.ToDataTable i GridView.DataBind w około cztery linijki efektywnego kodu. W podstawowych scenariuszach nie jest wymagańe ręczne tworzenie kolumn ani iteracja wierszy.

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();

Imports IronXL
Imports System.Data

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

' True = treat first row as column headers
Dim dataTable As DataTable = sheet.ToDataTable(True)

GridView1.DataSource = dataTable
GridView1.DataBind()

Wywołanie ToDataTable(true) nakazuje IronXL przekształcenie pierwszego wiersza arkusza na nazwy kolumn w wynikowym DataTable. Po powiązaniu tej tabeli z GridView za pomocą AutoGenerateColumns="true", ASP.NET automatycznie tworzy jedną kolumnę na każdy nagłówek w Excelu.

Jak utworzyć stronę ASP.NET Web Forms do importowania plików Excel?

Minimalna strona importu wymaga trzech elementów sterujących: pola do przesyłania plików, przycisku przesyłania oraz GridView. Dodaj następujący kod ASPX wewnątrz elementu <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" />

<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" />

Atrybut CssClass wiąże siatkę z arkuszem stylów Bootstrap, jeśli go używasz, zapewniając stylizowane wiersze i obramowania bez dodatkowej konfiguracji.

W kodzie źródłowym obsłuż zdarzenie kliknięcia przycisku. Poniższy wzorzec zapisuje przesłany plik w tymczasowej ścieżce serwera, ładuje go za pomocą IronXL i wiąże wynikowy DataTable z siatką:

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;
}

Imports IronXL
Imports System.Data
Imports System.IO

Sub btnUpload_Click(sender As Object, e As EventArgs)
    If Not FileUpload1.HasFile Then Return

    Dim uploadDir As String = Server.MapPath("~/Uploads/")
    Directory.CreateDirectory(uploadDir) ' ensure directory exists

    Dim filePath As String = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName))
    FileUpload1.SaveAs(filePath)

    Dim workBook As WorkBook = WorkBook.Load(filePath)
    Dim sheet As WorkSheet = workBook.DefaultWorkSheet
    Dim dt As DataTable = sheet.ToDataTable(True)

    GridView1.DataSource = dt
    GridView1.DataBind()

    ' Store for later export operations
    Session("CurrentData") = dt
End Sub

W tej implementacji zastosowano styl instrukcji najwyższego poziomu dla logiki wewnątrz procedury obsługi zdarzenia, zachowując jednocześnie wymagańą sygnaturę zdarzenia Web Forms. Należy zauważyć, że Directory.CreateDirectory jest wywoływane defensywnie — jeśli folder Uploads już istnieje, wywołanie nie powoduje żadnej operacji.

Po wybraniu przez użytkownika pliku .xlsx i kliknięciu przycisku przesyłania siatka wypełnia się zawartością arkusza kalkulacyjnego. Nazwy kolumn pochodzą z pierwszego wiersza pliku Excel, a wszystkie kolejne wiersze stają się wierszami danych w tabeli.

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

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

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

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

Imports System.IO

Dim ext As String = Path.GetExtension(FileUpload1.FileName).ToLowerInvariant()
Dim allowed As String() = {".xls", ".xlsx"}

If Not allowed.Contains(ext) Then
    lblError.Text = "Only .xls and .xlsx files are accepted."
    Return
End If

Jak uzyskać dostęp do określonych arkuszy i zakresów komórek?

Gdy skoroszyt programu Excel zawiera wiele arkuszy, należy wskazać konkretny arkusz po nazwie, zamiast polegać na DefaultWorkSheet. IronXL udostępnia metodę GetWorkSheet, która przyjmuje nazwę karty arkusza jako ciąg znaków.

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();

Imports IronXL
Imports System.Data

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

' Access a named sheet
Dim salesSheet As WorkSheet = workBook.GetWorkSheet("Q4 Sales")

' Read a specific cell range
Dim topTen = salesSheet("A1:E11")

' Convert the entire workbook to a DataSet (one DataTable per sheet)
Dim allSheets As DataSet = workBook.ToDataSet()

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

Metoda ToDataSet jest przydatna, gdy aplikacja musi wyświetlać dane z wielu arkuszy lub umożliwić użytkownikowi wybór arkusza do wyświetlenia. Każdy DataTable w zwróconym DataSet odpowiada jednemu arkuszowi programu Excel, a nazwa tabeli jest zgodna z nazwą karty arkusza.

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();

Dim dt As DataTable = sheet.ToDataTable(True)
Dim dv As New DataView(dt) With {
    .RowFilter = "Status = 'Active'"
}

GridView1.DataSource = dv
GridView1.DataBind()

Jak porównać metody importu dla powiązania Excel GridView?

Różne podejścia do powiązania Excel-GridView mają swoje zalety i wady. Poniższa tabela zawiera podsumowanie najpopularniejszych metod, dzięki czemu można wybrać tę odpowiednią dla danego scenariusza.

IronXL obsługuje zarówno starszy format XLS, jak i nowoczesny format XLSX, nie wymaga instalacji sterowników po stronie serwera i zapewnia najniższą złożoność kodu spośród wymienionych opcji. W przypadku zespołów, które już korzystają z innych produktów Iron Software, takich jak IronPDF lub IronOCR, jedna licencja Iron Software obejmuje cały pakiet.

Jak wyeksportować dane z GridView z powrotem do Excela?

Przeprowadzenie pełnego cyklu — z Excela do siatki i z powrotem do Excela — jest równie zwięzłe dzięki IronXL. Ten wzorzec jest przydatny w przypadku przycisków "pobierz jako Excel", które pozwalają użytkownikom eksportować wszystko, co jest aktualnie wyświetlane w tabeli.

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();
}

Imports System
Imports System.Data
Imports System.IO

Sub btnExport_Click(sender As Object, e As EventArgs)
    Dim dt As DataTable = TryCast(Session("CurrentData"), DataTable)
    If dt Is Nothing Then Return

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

    ' Write header row
    For col As Integer = 0 To dt.Columns.Count - 1
        ws.SetCellValue(0, col, dt.Columns(col).ColumnName)
    Next

    ' Write data rows
    For row As Integer = 0 To dt.Rows.Count - 1
        For col As Integer = 0 To dt.Columns.Count - 1
            ws.SetCellValue(row + 1, col, If(dt.Rows(row)(col)?.ToString(), String.Empty))
        Next
    Next

    Dim exportDir As String = Server.MapPath("~/Exports/")
    Directory.CreateDirectory(exportDir)
    Dim exportPath As String = 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()
End Sub

Wywołanie Response.TransmitFile przesyła zapisany plik do przeglądarki, wywołując okno dialogowe pobierania. Nagłówek Content-Disposition: attachment zapewnia, że przeglądarki pobierają plik, zamiast próbować wyświetlać go wbudowanym.

// 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);

' 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)

Jakie są Twoje kolejne kroki?

Teraz dysponujesz kompletnym, niewymagającym sterowników procesem importowania plików Excel do widoku GridView w ASP.NET oraz eksportowania danych z GridView z powrotem do Excelu przy użyciu IronXL. Oto, co warto zbadać dalej, aby rozwinąć tę podstawę:

• Zapoznaj się z dokumentacją IronXL, aby uzyskać pełny opis Dokumentacji API, w tym informacje dotyczące obliczania formuł, operacji na zakresach komórek oraz tworzenia wykresów.
• Zapoznaj się z biblioteką przykładów kodu IronXL, zawierającą gotowe do użycia fragmenty kodu dotyczące importu plików CSV, skoroszytów chronionych hasłem, formatowania warunkówego i nie tylko.
• Jeśli chcesz uzyskać bardziej szczegółowe informacje na temat mapowania kolumn typowanych i obsługi wartości null, wypróbuj samouczek "Excel to DataTable".
• Sprawdź stronę licencyjną IronXL, aby zapoznać się z opcjami od licencji deweloperskich po dystrybucję OEM.
• Zapoznaj się z przewodnikiem Iron Software dotyczącym odczytu plików Excel w środowisku .NET, aby szczegółowo zrozumieć nawigację po skoroszytach i arkuszach.
• Porównaj IronXL z alternatywnymi rozwiązaniami, korzystając z porównania bibliotek C# dla programu Excel, które zawiera szczegółowe zestawienie funkcji w porównaniu z OLEDB, EPPlus i Open XML SDK.

W przypadku aplikacji .NET Core i ASP.NET Core ten sam interfejs API IronXL działa w Razor Pages i kontrolerach MVC. Przewodnik IronXL for .NET Core omawia różnice w obsłudze przesyłania plików oraz wzorcach wstrzykiwania zależności.

Zacznij od bezpłatnej wersji próbnej IronXL, aby przetestować wszystkie funkcje w swoim projekcie przed zakupem. Do uzyskania licencji Trial nie jest wymagańa karta kredytowa.