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.Excel

Po zainstalowaniu NuGet dodaje wszystkie wymagane 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 oba formaty: .xls (Excel 97-2003) oraz .xlsx (Excel 2007+), więc nie musisz oddzielnie obsługiwać 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 czterech liniach skutecznego kodu. W podstawowych scenariuszach nie jest wymagane 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) mówi IronXL, aby awansować pierwszy wiersz arkusza do nazw kolumn w wyniku DataTable. Gdy powiążesz tę tabelę z GridView za pomocą AutoGenerateColumns="true", ASP.NET automatycznie tworzy jedną kolumnę na każdy nagłówek Excela.

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

Minimalna strona importu potrzebuje trzech kontrolek: wejścia do przesyłania plików, przycisku przesyłania oraz GridView. Dodaj następujący znacznik 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 łączy grid z arkuszem stylów Bootstrap, jeśli go używasz, dając ci stylizowane wiersze i granice bez dodatkowej konfiguracji.

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

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 wymaganą sygnaturę zdarzenia Web Forms. Zwróć uwagę, że Directory.CreateDirectory jest wywoływane defensywnie — jeśli folder Uploads już istnieje, wywołanie nie robi nic.

Po wybraniu pliku .xlsx przez użytkownika i kliknięciu przycisku ładowania, grid 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).ToNiskierInvariant();
string[] allowed = { ".xls", ".xlsx" };

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

string ext = Path.GetExtension(FileUpload1.FileName).ToNiskierInvariant();
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?

Kiedy skoroszyt Excel zawiera wiele arkuszy, musisz wycelować w konkretny arkusz po nazwie, zamiast polegać na DefaultWorkSheet. IronXL dostarcza metodę GetWorkSheet, która akceptuje nazwę zakładki 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 twoja aplikacja musi pokazywać dane z wielu arkuszy lub umożliwiać użytkownikowi wybór, który arkusz zobaczyć. Każdy DataTable w zwróconym DataSet odpowiada jednemu arkuszowi Excel, a nazwa tabeli odpowiada nazwie zakładki 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 strumieniuje zapisany plik do przeglądarki, wywołując dialog pobierania. Nagłówek Content-Disposition: attachment zapewnia, że przeglądarki pobierają plik zamiast próbować wyświetlić go w lini.

// 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 warunkowego i nie tylko.
• Wypróbuj tutorial Excel do DataTable, jeżeli chcesz pełniejszego omówienia mapowania typowanych kolumn i obsługi null.
• Sprawdź stronę licencyjną IronXL, aby zapoznać się z opcjami od licencji deweloperskich po dystrybucję OEM.
• Przeglądaj przewodnik po czytaniu Excela dla .NET od Iron Software, aby dokładnie zrozumieć nawigację po skoroszytach i arkuszach kalkulacyjnych.
• Porównaj IronXL z alternatywami, używając porównania bibliotek Excel C# dla rozkładu funkcji na funkcje wobec 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 ASP.NET Core omawia różnice w obsłudze przesyłania plików i 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 wymagana karta kredytowa.