ASP.NET C# ile GridView'e Excel Nasıl İçe Aktarılır

Excel GridView Entegrasyonu için IronXL'i Nasıl Yüklersiniz?

Herhangi bir kod yazmadan önce IronXL'i ASP.NET projenize eklemeniz gerekir. En hızlı yol, Visual Studio Paket Yöneticisi Konsolu veya .NET CLI'dan NuGet üzerinden yapılır.

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Yüklendikten sonra, NuGet projenize gerekli tüm referansları ekler. Yüklenecek harici sürücüler, kaydedilecek OLEDB sağlayıcılar ve sunucuda Microsoft Office'e bağımlılık yoktur. Kütüphane, tek bir yönetilen montaj olarak gelir ve Windows, Linux, macOS ve Azure App Service dahil olmak üzere bulut barındırma ortamlarında çalışır.

Kurulumdan sonra, Excel verilerini okuyan veya yazan herhangi bir kod-arkası dosyasına aşağıdaki ad alanlarını ekleyin:

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 hem .xls (Excel 97-2003) hem de .xlsx (Excel 2007+) formatlarını destekler, bu yüzden her dosya türü için ayrı bir işlem yapmanıza gerek yoktur. Aynı WorkBook.Load çağrısı, dosya imzasını otomatik olarak inceleyerek her iki formatı da yönetir.

Excel Verilerini GridView'a Yüklemenin En Hızlı Yolu Nedir?

En hızlı yöntem, yaklaşık dört satır etkili kod halinde WorkBook.Load, sheet.ToDataTable ve GridView.DataBind'yi bir araya getirir. Temel senaryolar için manuel sütun oluşturma ve satır yineleme gerekmez.

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

ToDataTable(true) çağrısı, IronXL'ye çalışma sayfasının ilk satırını ortaya çıkan DataTable'deki sütun adlarına terfi ettirmesi talimatını verir. GridView'ye AutoGenerateColumns="true" ile o tabloyu bağladığınızda, ASP.NET, her Excel başlığı için otomatik olarak bir sütun oluşturur.

Excel İçe Aktarmak İçin Bir ASP.NET Web Formu Sayfası Nasıl Oluşturulur?

Minimal bir ithalat sayfası üç kontrol gerektirir: bir dosya yükleme girişi, bir gönderme düğmesi ve GridView. Aşağıdaki ASPX işaretlemesini <form runat="server"> elemanınızın içine ekleyin:

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

CssClass özelliği, kullanıyorsanız gridinizi Bootstrap stil sayfanızla entegre eder ve ek yapılandırma sağlamadan stillendirilmiş satırlar ve sınırlar sunar.

Kod arkasında, düğme tıklama olayını ele alın. Aşağıdaki kalıp, yüklenen dosyayı geçici bir sunucu yoluna kaydeder, IronXL ile yükler ve ortaya çıkan DataTable'yi grid'e bağlar:

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

Bu uygulama, Web Formu olay imzasını korurken olay işleyicideki mantık için üst düzey ifadeler stilini takip eder. Directory.CreateDirectory çağrısının savunma amaçlı yapıldığına dikkat edin -- eğer Uploads klasörü zaten mevcutsa, çağrı bir iş yapmaz.

Kullanıcı bir .xlsx dosyası seçip yükleme düğmesine tıkladıktan sonra, grid elektronik tablo içeriği ile dolar. Excel dosyasının ilk satırından sütun isimleri gelir ve ardından gelen tüm satırlar ızgarada veri satırları olur.

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

Özel Çalışma Sayfalarına ve Hücre Aralıklarına Nasıl Erişilir?

Bir Excel çalışma kitabı birden çok sayfa içerdiğinde, DefaultWorkSheet'ya güvenmek yerine belirli bir tanesini isme göre hedeflemeniz gerekir. IronXL, yaprak sekme adını string olarak kabul eden bir GetWorkSheet yöntemi sağlar.

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

ToDataSet yöntemi, uygulamanızın birden fazla sayfadan veri görüntülemesi gerektiğinde veya kullanıcının hangi sayfayı görüntüleyeceğini seçmesine izin verdiğinde işe yarar. Dönen DataSet içindeki her DataTable bir Excel çalışma sayfasına karşılık gelir ve tablo adı sayfa sekme adı ile eşleşir.

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

Excel GridView Bağlama İçin İçeri Aktarma Yöntemlerini Nasıl Karşılaştırırsınız?

Excel'den GridView'a bağlama için farklı yaklaşımlar farklı ödünler içerir. Aşağıdaki tablo, senaryonuz için doğru olanı seçebilmeniz için en yaygın yöntemleri özetler.

IronXL, hem eski XLS hem de modern XLSX formatlarını kapsar, sunucu tarafı sürücü yüklemesi gerektirmez ve listelenen seçenekler arasında en düşük kod karmaşıklığını sağlar. Zaten IronPDF veya IronOCR gibi diğer Iron Software urunlerini kullanan ekipler için, tek bir Iron Software lisansı tüm suite'i kapsar.

GridView Verilerini Excel'e Geri Nasıl Aktarırsınız?

Excel'den grid'e ve geri Excel'e olan tur-tamamlaması, IronXL ile eşit derecede kısadır. "Excel olarak indir" düğmeleri kullanıcıların grid'de şu anda görüntülenenleri dışa aktarmasına olanak tanır ve bu desen bu işlev için kullanışlıdır.

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

Response.TransmitFile çağrısı, kaydedilen dosyayı tarayıcıya aktarır ve bir indirme diyaloğunu tetikler. Content-Disposition: attachment başlığı, tarayıcıların dosyayı satır içi olarak görüntülemeye çalışmak yerine indirmelerini sağlar.

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

Sıradaki Adımlarınız Neler?

Artık bir ASP.NET GridView'a Excel dosyalarını içe aktarmak ve GridView verilerini Excel'e geri dışa aktarmak için sürücüsüz bir hattınız var. Bu temelin üzerinde inşa etmek için bir sonraki keşfetmeniz gerekenler burada:

• Tam API referansı ve formül değerlendirmesi, hücre aralığı işlemleri ve grafik oluşturma dahil olmak üzere IronXL belgelerini okuyun.
• Çalıştırmaya hazır snippet'ler için IronXL kod örnekleri kütüphanesini keşfedin, CSV import, parolayla korunan çalışma kitapları, koşullu formatlama ve daha fazlasını kapsar.
• Type'lı kolon eşlemesi ve null işleme hakkında daha derin bilgi istiyorsanız Excel'den DataTable'a öğretici deneyin.
• Geliştirme lisanslarından OEM yeniden dağıtıma kadar seçenekleri gözden geçirmek için IronXL lisanslama sayfasına bakın.
• Çalışma kitabı ve çalışma sayfası navigasyonunu anlamak için Iron Software'in .NET Excel okuma rehberini gözden geçirin.
• Alternatiflerle IronXL'yi karşılaştırmak için C# Excel kütüphane karşılaştırmasını kullanarak OLEDB, EPPlus ve Open XML SDK'ya karşı özellik bazında bir döküm.

.NET Core ve ASP.NET Core uygulamaları için, aynı IronXL API'sı Razor Pages ve MVC kontrolörlerinde çalışır. IronXL ASP.NET Core rehberi, dosya yükleme işleme ve bağımlılık enjeksiyon desenlerindeki farkları açıkça anlatır.

Satın almadan önce projenizde tüm özellikleri test etmek için IronXL ücretsiz deneme ile başlayın. Deneme lisansı için kredi kartına gerek yoktur.