ASP.NET Core'da Excel Dosyası Nasıl Açılır

IronXL Nedir?

IronXL, Microsoft Excel veya Office Interop bağımlılıkları gerektirmeden Excel belgeleriyle çalışmak için işlevsellik sağlayan bir .NET Excel kütüphanesidir. .NET Framework ve .NET Core'u destekleyerek, sadece birkaç satır kodla Excel dosyalarını yazma, değiştirme ve okuma yeteneklerini sunar. Excel dosyalarını okumaya yönelik ayrıntılı bir eğitim için lütfen bu Excel eğitimine başvurun.

IronXL kütüphanesi Excel belgelerini okuma ve yazma, onlardan veri çekme, veriyi değiştirme ve hatta sıfırdan yeni Excel dosyaları oluşturma yeteneğine sahiptir. IronXL sadece .XLS formatını değil, aynı zamanda .XLSX ile de uyumludur, Microsoft tarafından e-tabloları temsil etmek için geliştirilen XML tabanlı bir dosya formatıdır.

Ön Koşullar

Koda dalmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

1. .NET Core 3.1 veya daha yüksek sürümü yüklü.
2. .NET geliştirme için uygun bir IDE (Microsoft Visual Studio önerilir).
3. ASP.NET Core ve Razor Sayfalar hakkında temel bilgi.

Yeni bir .NET Core Projesi Oluşturun

1. Microsoft Visual Studio'yu açın ve "Create a new project" seçeneğini seçin.
2. Proje şablonları listesinden "ASP.NET Core Web App" seçin ve "İleri"ye tıklayın.
3. Projeniz için bir ad verin, örneğin, "Open_ExcelFile.NET_Core", bir konum seçin ve "İleri"ye tıklayın.
4. Hedef framework olarak ".NET Core" ve sürüm olarak "ASP.NET Core 3.1 veya daha yüksek" seçin. "Proje şablonu" bölümünde "Web Application" seçin ve "Create"ye tıklayın.

Razor Sayfası Oluşturun

Şimdi, Excel dosyasını açmak için kod yazacağımız bir Razor Sayfası oluşturalım.

1. Solution Explorer'da "Pages" klasörüne sağ tıklayın ve "Ekle" > "Razor Page" seçeneğini seçin.
2. Sayfa adı olarak "ExcelOpener" girin ve "Add"e tıklayın.

Yeni bir Razor Sayfası oluşturun

Bu işlem iki dosya oluşturacaktır: ExcelOpener.cshtml ve ExcelOpener.cshtml.cs.

ExcelOpener.cshtml dosyası sayfanın HTML işaretlemesini, ExcelOpener.cshtml.cs dosyası ise sayfanın C# arka plan kodunu içerir.

Excel Dosyalarını Okuma

Koda dalalım. Sağlanan ExcelOpenerModel sınıfı bir Razor Sayfası Modelidir. Bu sınıfın, Excel dosyasından okunan verileri depolamak için kullanılacak Data adlı bir List<List<string>> özelliği vardır.

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

OnGet yönteminde, IronXL, bir Excel dosyasını yüklemek ve varsayılan çalışma sayfasından (çalışma kitabındaki ilk sayfa) verileri okumak için kullanılır. Her satır bir List<string> olarak temsil edilir ve bu listeler daha sonra Data özelliğine eklenir.

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

Excel Dosyalarını Yazma

ExcelOpenerModel sınıfındaki OnPost yöntemi, Excel dosyasındaki değişiklikleri kaydetmek için kullanılır. İlk olarak, Excel dosyasını yükler ve varsayılan çalışma sayfasını alır. Daha sonra, Data değerlerini çalışma sayfasındaki hücrelere yazar ve çalışma kitabını yeni bir dosyaya kaydeder.

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

Excel Verilerini Düzenlemek İçin HTML Formu

ExcelOpener.cshtml dosyasında, Excel dosyasından verileri görüntülemek ve düzenlemek için bir form tanımlanmıştır. Her bir hücre değeri bir metin giriş alanında görüntülenir. Düzenlendikten sonra, 'Kaydet' düğmesine tıklamak formu gönderecek, OnPost yöntemini tetikleyecek ve değişiklikleri Excel dosyasına kaydedecektir.

@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>

Sayfaya Gitme

_Layout.cshtml dosyasında, sayfaya bir bağlantı gezinme menüsüne eklenmiştir. Bu bağlantıya tıklayarak Excel açıcı sayfasına gidebilirsiniz.

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

Uygulamayı Çalıştırma ve Çıktısını Açıklama

Visual Studio'da 'Build' düğmesine tıklayarak veya Ctrl + Shift + B kısayolunu kullanarak uygulamayı derleyin. Uygulamayı F5 tuşuna basarak veya Visual Studio'da "Başlat" butonuna tıklayarak çalıştırın.

Uygulama çalıştığında, gezinme çubuğundaki ilgili bağlantıya tıklayarak "ExcelOpener" sayfasına gidin. Sayfa, Excel'deki verileri tablo formatında gösterecektir.

Tablodaki verileri değiştirebilir ve değişiklikleri Excel dosyasına kaydetmek için "Kaydet" butonuna tıklayabilirsiniz.

Web Uygulamasında Excel verilerini görüntüle

Bu eğitimde IronXL kullanarak ASP.NET Core uygulamasında bir Excel dosyasının nasıl açılacağını gösterdik. IronXL, Excel dosyalarını okumak ve değiştirmek için basit ve kullanışlı bir yol sunar. Daha gelişmiş özellikler ve işlevsellik için IronXL belgelendirmesini keşfedebilirsiniz.

IronXL, ücretsiz deneme sunarak yeteneklerini değerlendirmenizi sağlar. Projeleriniz için faydalı bulursanız, $999'dan başlayan bir lisans satın alabilirsiniz.