.NET Core için Excel API'si Oluşturun: XLSX Dosyaları Oluşturun, Okuyun ve Dışa Aktarın

.NET Core Projesine IronXL Nasıl Yüklenir?

NuGet Paket Yöneticisi Konsolu ile herhangi bir .NET 10 projesine IronXL ekleyin:

Install-Package IronXl.Excel

Ya da IronXl araması yaparak Visual Studio NuGet UI'den yükleyin. NuGet üzerindeki paket adı IronXl.Excel.

Kurulumdan sonra, kitaplık oluşturan veya okuyan herhangi bir dosyaya using IronXL; ekleyin. Hiçbir Office interop kütüphanesi, COM kaydı ve ev sahibi makinede Microsoft Excel kurulumu gerekmez -- IronXL tamamen özeldir.

IronXL .NET Standard 2.0 ve üstünü hedefler, bu da aynı kütüphanenin .NET Core, .NET 5/6/7/8/9/10 ve .NET Framework projeleri için çalıştığı anlamına gelir. IronXL dokümantasyonu tüm desteklenen ortamları ayrıntılı olarak kapsar.

.NET Core'da Excel Dosyaları Programlı Olarak Nasıl Oluşturulur?

IronXL'nin sezgisel API'si ile baştan Excel belgeleri oluşturmak sadece birkaç satır kod gerektirir. Kütüphane, temiz bir nesne modeli aracılığıyla kitaplar, çalışma sayfaları, hücre stilleri ve formüller üzerinde tam kontrol sağlar.

İşte biçimlendirilmiş verilerle yeni bir Excel çalışma kitabı oluşturan, çalışma sayfası yönetimini gösteren ve hücre stilleri uygulayan bir denetleyici eylemi:

using IronXL;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class ExcelController : ControllerBase
{
    [HttpGet("create-report")]
    public IActionResult CreateSalesReport()
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Sales Data");

        // Set header labels in the first row
        worksheet["A1"].Value = "Product";
        worksheet["B1"].Value = "Q1 Sales";
        worksheet["C1"].Value = "Q2 Sales";
        worksheet["D1"].Value = "Total";

        // Bold headers and apply a blue background with white text
        worksheet["A1:D1"].Style.Font.Bold = true;
        worksheet["A1:D1"].Style.SetBackgroundColor("#4472C4");
        worksheet["A1:D1"].Style.Font.SetColor("#FFFFFF");

        // Add data rows
        worksheet["A2"].Value = "Widget Pro";
        worksheet["B2"].Value = 15000;
        worksheet["C2"].Value = 18500;
        worksheet["D2"].Formula = "=B2+C2";

        worksheet["A3"].Value = "Gadget Plus";
        worksheet["B3"].Value = 22000;
        worksheet["C3"].Value = 24000;
        worksheet["D3"].Formula = "=B3+C3";

        // Apply currency number format to sales columns
        worksheet["B2:D3"].Style.Format = "$#,##0";

        // Stream the XLSX file back to the caller
        var stream = workbook.ToStream();
        return File(
            stream,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "SalesReport.xlsx");
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class ExcelController : ControllerBase
{
    [HttpGet("create-report")]
    public IActionResult CreateSalesReport()
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Sales Data");

        // Set header labels in the first row
        worksheet["A1"].Value = "Product";
        worksheet["B1"].Value = "Q1 Sales";
        worksheet["C1"].Value = "Q2 Sales";
        worksheet["D1"].Value = "Total";

        // Bold headers and apply a blue background with white text
        worksheet["A1:D1"].Style.Font.Bold = true;
        worksheet["A1:D1"].Style.SetBackgroundColor("#4472C4");
        worksheet["A1:D1"].Style.Font.SetColor("#FFFFFF");

        // Add data rows
        worksheet["A2"].Value = "Widget Pro";
        worksheet["B2"].Value = 15000;
        worksheet["C2"].Value = 18500;
        worksheet["D2"].Formula = "=B2+C2";

        worksheet["A3"].Value = "Gadget Plus";
        worksheet["B3"].Value = 22000;
        worksheet["C3"].Value = 24000;
        worksheet["D3"].Formula = "=B3+C3";

        // Apply currency number format to sales columns
        worksheet["B2:D3"].Style.Format = "$#,##0";

        // Stream the XLSX file back to the caller
        var stream = workbook.ToStream();
        return File(
            stream,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "SalesReport.xlsx");
    }
}

Imports IronXL
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class ExcelController
    Inherits ControllerBase

    <HttpGet("create-report")>
    Public Function CreateSalesReport() As IActionResult
        ' Create a new Excel workbook in XLSX format
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Sales Data")

        ' Set header labels in the first row
        worksheet("A1").Value = "Product"
        worksheet("B1").Value = "Q1 Sales"
        worksheet("C1").Value = "Q2 Sales"
        worksheet("D1").Value = "Total"

        ' Bold headers and apply a blue background with white text
        worksheet("A1:D1").Style.Font.Bold = True
        worksheet("A1:D1").Style.SetBackgroundColor("#4472C4")
        worksheet("A1:D1").Style.Font.SetColor("#FFFFFF")

        ' Add data rows
        worksheet("A2").Value = "Widget Pro"
        worksheet("B2").Value = 15000
        worksheet("C2").Value = 18500
        worksheet("D2").Formula = "=B2+C2"

        worksheet("A3").Value = "Gadget Plus"
        worksheet("B3").Value = 22000
        worksheet("C3").Value = 24000
        worksheet("D3").Formula = "=B3+C3"

        ' Apply currency number format to sales columns
        worksheet("B2:D3").Style.Format = "$#,##0"

        ' Stream the XLSX file back to the caller
        Dim stream = workbook.ToStream()
        Return File(
            stream,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "SalesReport.xlsx")
    End Function
End Class

Web API'lerinde Excel Verisi Nasıl Okunur?

Kullanıcı tarafından yüklenen Excel dosyalarından veri içe aktarma, elektronik tablo içeriğini işleyen herhangi bir web uygulaması için gereklidir. IronXL, Excel elektronik tablolarını doğrudan okumayı sağlamak için akışlardan, dosya yollarından veya bayt dizilerinden yükleme, satırları yineleme ve her hücreden yazılmış değerleri çekme gibi işlemleri yapar.

[HttpPost("import")]
public IActionResult ImportExcelData(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = file.OpenReadStream();

    // Load the workbook directly from the upload stream
    WorkBook workbook = WorkBook.Load(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;

    var records = new List<Dictionary<string, object>>();

    // Start at row 2 to skip the header row
    for (int row = 2; row <= worksheet.RowCount; row++)
    {
        var record = new Dictionary<string, object>
        {
            ["Product"] = worksheet[$"A{row}"].StringValue,
            ["Sales"]   = worksheet[$"B{row}"].DecimalValue,
            ["Date"]    = worksheet[$"C{row}"].DateTimeValue
        };
        records.Add(record);
    }

    return Ok(new {
        message     = "Import successful",
        recordCount = records.Count,
        data        = records
    });
}

[HttpPost("import")]
public IActionResult ImportExcelData(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = file.OpenReadStream();

    // Load the workbook directly from the upload stream
    WorkBook workbook = WorkBook.Load(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;

    var records = new List<Dictionary<string, object>>();

    // Start at row 2 to skip the header row
    for (int row = 2; row <= worksheet.RowCount; row++)
    {
        var record = new Dictionary<string, object>
        {
            ["Product"] = worksheet[$"A{row}"].StringValue,
            ["Sales"]   = worksheet[$"B{row}"].DecimalValue,
            ["Date"]    = worksheet[$"C{row}"].DateTimeValue
        };
        records.Add(record);
    }

    return Ok(new {
        message     = "Import successful",
        recordCount = records.Count,
        data        = records
    });
}

Imports Microsoft.AspNetCore.Mvc
Imports System.Collections.Generic
Imports IronXL

<HttpPost("import")>
Public Function ImportExcelData(file As IFormFile) As IActionResult
    If file Is Nothing OrElse file.Length = 0 Then
        Return BadRequest("No file uploaded")
    End If

    Using stream = file.OpenReadStream()
        ' Load the workbook directly from the upload stream
        Dim workbook As WorkBook = WorkBook.Load(stream)
        Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

        Dim records As New List(Of Dictionary(Of String, Object))()

        ' Start at row 2 to skip the header row
        For row As Integer = 2 To worksheet.RowCount
            Dim record As New Dictionary(Of String, Object) From {
                {"Product", worksheet($"A{row}").StringValue},
                {"Sales", worksheet($"B{row}").DecimalValue},
                {"Date", worksheet($"C{row}").DateTimeValue}
            }
            records.Add(record)
        Next

        Return Ok(New With {
            .message = "Import successful",
            .recordCount = records.Count,
            .data = records
        })
    End Using
End Function

Excel Verisini Farklı Formatlara Nasıl Dışa Aktarırsınız?

Uygulamalar genellikle birden fazla çıktı formatında elektronik tablolar sunmalıdır. IronXL, herhangi bir dış dönüşüm aracı gerektirmeden, tek bir yöntem çağrısıyla XLSX, XLS, CSV, JSON ve HTML'ye dışa aktarmayı destekler.

[HttpGet("export/{format}")]
public IActionResult ExportData(string format)
{
    // Load a pre-designed template workbook
    WorkBook workbook = WorkBook.Load("template.xlsx");

    return format.ToLower() switch
    {
        "xlsx" => File(
            workbook.ToStream(),
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "export.xlsx"),

        "csv"  => File(
            workbook.ToStream(FileFormat.CSV),
            "text/csv",
            "export.csv"),

        "json" => Ok(workbook.ToJson()),

        _      => BadRequest("Unsupported format")
    };
}

[HttpGet("export/{format}")]
public IActionResult ExportData(string format)
{
    // Load a pre-designed template workbook
    WorkBook workbook = WorkBook.Load("template.xlsx");

    return format.ToLower() switch
    {
        "xlsx" => File(
            workbook.ToStream(),
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "export.xlsx"),

        "csv"  => File(
            workbook.ToStream(FileFormat.CSV),
            "text/csv",
            "export.csv"),

        "json" => Ok(workbook.ToJson()),

        _      => BadRequest("Unsupported format")
    };
}

Imports Microsoft.AspNetCore.Mvc

<HttpGet("export/{format}")>
Public Function ExportData(format As String) As IActionResult
    ' Load a pre-designed template workbook
    Dim workbook As WorkBook = WorkBook.Load("template.xlsx")

    Select Case format.ToLower()
        Case "xlsx"
            Return File(workbook.ToStream(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "export.xlsx")
        Case "csv"
            Return File(workbook.ToStream(FileFormat.CSV), "text/csv", "export.csv")
        Case "json"
            Return Ok(workbook.ToJson())
        Case Else
            Return BadRequest("Unsupported format")
    End Select
End Function

Önceden tanımlanmış düzenlere sahip Excel şablonları kullanmak, rapor oluşturmayı hızlandırır. Önceden tasarlanmış bir çalışma kitabı yükleyin, adlandırılmış hücrelere veya aralıklara dinamik veri ekleyin ve sonra sonucu akışa alın. Bu yaklaşım, biçimlendirme tutarlılığının esneklikten daha önemli olduğu satış raporları, faturalar ve uyum belgeleri için uygundur.

IronXL'nin platformlar arası desteği, bu dosya işlemlerinin Windows, Linux ve macOS'te aynı şekilde çalıştığı anlamına gelir, bu da .NET Core kapsüllenmiş dağıtımı için uygundur. IronXL platformlararası kılavuzunda daha fazlasını okuyun.

Koşullu Biçimlendirme ve Veri Çubukları Nasıl Uygulanır?

Temel hücre stillerinin ötesinde, IronXL koşullu biçimlendirme kurallarını destekler -- eşik değerinin üzerindeki hücreleri yeşil renkle vurgulamak, negatif değerleri kırmızı renkle işaretlemek veya eğilimleri hemen görülebilir hale getirmek için gradyan veri çubukları uygulamak üzere.

Koşullu biçimlendirme, okuyucuların sapmaları hızlıca fark etmesi gereken finansal panolar ve KPI raporlarında özellikle değerlidir. Alıcının indirdikten sonra kendi biçimlendirmesini uygulamasına güvenmek yerine, kurallar XLSX dosyasına gömülü taşınır ve dosya herhangi bir Microsoft Excel veya uyumlu görüntüleyici sürümünde açıldığında otomatik olarak değerlendirilir.

Koşullu biçimlendirme, çalışma sayfasının ConditionalFormatting özelliği aracılığıyla ayarlanır. Kurallar, adlandırılmış bir hücre aralığına uygulanır ve birden fazla koşul türünü destekler: hücre değeri karşılaştırmaları, formül tabanlı kurallar, düşükten yüksek değerlere kadar derecelendirme yapan renk skalaları ve hücre çubuğu grafikleri gibi işlev gören veri çubuğu bindirmeleri. Open XML spesifikasyonu, IronXL'nin XLSX dosyasına yazdığı temel kural yapısını tanımlar.

Renk skalaları, ikon setleri ve veri çubukları uygulama ile ilgili tam bir referans için, IronXL dokümanlarındaki koşullu biçimlendirme eğitimine bakın.

Excel Dosyaları ve Çalışma Sayfaları Nasıl Korunur?

Hassas veriler içeren raporların dağıtımı bir erişim kontrolü katmanı gerektirir. IronXL, hem çalışma kitabı seviyesinde parola korumasını hem de çalışma sayfası seviyesinde korumayı destekler:

• Çalışma kitabı parolası: XLSX dosyasını şifrelemek için .SaveAs() çağırmadan önce workbook.Password = "secret" ayarlayın. Alıcılar, Excel'de açmak için parolayı girmelidir.
• Çalışma sayfası koruması: Hücre düzenlemeyi kilitlemek için worksheet.ProtectSheet("password") çağırın, ancak yine de sayfa görüntülenebilir. Belirli aralıklar, AllowEditRange API'si kullanılarak veri girişi için kilitsiz hale getirilebilir.
• Sadece okunur dağıtımı: Asla düzenlenmemesi gereken belgeler için, çalışma sayfası korumasını dosya seviyesi şifreleme ile birleştirin.

Komut dosyasıyla korunan XLSX dosyaları varsayılan olarak AES-128 şifreleme kullanır, bu, yerel Excel'in uyguladığı aynı standarttır. IronXL aracılığıyla korunan bir dosya, Excel'in yerleşik açık-dosya istemi ile tamamen uyumludur -- alıcının tarafında özel bir görüntüleyici gerekmez.

Bu güvenlik özellikleri, standart .NET Core güvenlik modeli ile tamamlayıcıdır ve özellikle finans veya İK raporlama uç noktalarını oluştururken faydalıdır. Dosya koruma dokümantasyonu, tam API referansını sağlar.

.NET'te Excel Formülleri Nasıl Çalışır?

IronXL'nin yerleşik hesaplama motoru, standart Excel formüllerini çalışma zamanında değerlendirir, böylece API, diske kaydetmeden ve Excel'de yeniden açmadan hesaplanmış değerler döndürebilir. Herhangi bir hücrenin .Formula özelliğine bir formül dizesi atayın:

// Sum a column and place the result in a footer row
worksheet[$"B{lastRow}"].Formula = $"=SUM(B2:B{lastRow - 1})";

// Calculate an average across a range
worksheet[$"C{lastRow}"].Formula = $"=AVERAGE(C2:C{lastRow - 1})";

// Retrieve the computed value immediately
decimal total = worksheet[$"B{lastRow}"].DecimalValue;

// Sum a column and place the result in a footer row
worksheet[$"B{lastRow}"].Formula = $"=SUM(B2:B{lastRow - 1})";

// Calculate an average across a range
worksheet[$"C{lastRow}"].Formula = $"=AVERAGE(C2:C{lastRow - 1})";

// Retrieve the computed value immediately
decimal total = worksheet[$"B{lastRow}"].DecimalValue;

' Sum a column and place the result in a footer row
worksheet($"B{lastRow}").Formula = $"=SUM(B2:B{lastRow - 1})"

' Calculate an average across a range
worksheet($"C{lastRow}").Formula = $"=AVERAGE(C2:C{lastRow - 1})"

' Retrieve the computed value immediately
Dim total As Decimal = worksheet($"B{lastRow}").DecimalValue

IronXL, matematik, istatistik, metin, tarih ve arama kategorilerini içeren çoğu standart Excel işlevini destekler. Gelişmiş senaryolar için dizi formülleri (Ctrl+Shift+Enter semantiği) de desteklenir. Formula değerlendirmeleri .NET işlemi içinde gerçekleştiğinden, dış bir hesaplama servisine gidiş-geliş yolculuğu olası değildir -- formül atandıktan hemen sonra sonuçlar hazırdır, bu binlerce satırlık hesaplamalarda bile API yanıt sürelerini öngörülebilir kılar. Formül destek referansı tüm desteklenen işlevleri listeler.

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

IronXL ile bir Excel API'si oluşturmak, .NET Core uygulamalarına hesap tablolarıyla çalışmak için sağlam yetenekler sağlar. Biçimlendirilmiş veri ve hesaplanan formüller ile XLSX dosyaları oluşturmak, kullanıcı yüklemelerini içe aktarmak ve verileri birden fazla formatta dışa aktarmaktan, IronXL çapraz platformda, Office bağımsız programatik hesap tablosu manipülasyonunun her yönünü halleder.

Daha ileri gitmek icin bu kaynaklari inceleyin:

• IronXL ürün sayfası -- özellik özeti ve başlangıç kılavuzu
• IronXL belgeleri -- tam API referansı ve nasıl yapılır makaleleri
• C# ile Excel dosyaları oluşturun -- çalışma kitabı ve çalışma sayfası oluşturma üzerine ayrıntılı öğretici
• C# ile Excel dosyalarını okuyun -- yükleme, çözümleme ve veri çıkarma
• Excel'i CSV'ye aktarın -- kodlama ve ayırıcı seçenekleriyle CSV dışa aktarımı
• Hücre biçimlendirme API'si -- yazı tipleri, renkler, kenarlıklar ve sayı biçimleri
• Koşullu biçimlendirme -- kurallar, veri çubukları, renk ölçekleri
• Formül desteği -- desteklenen Excel işlevleri referansı
• Dosya koruması -- çalışma kitabı ve çalışma sayfası şifre API'leri
• NuGet paketi -- mevcut sürüm ve sürüm geçmişi

Ücretsiz deneme başlatın ve IronXL'yı canlı bir projede test edin veya üretim dağıtımı için doğru planı bulmak üzere lisans seçeneklerini inceleyin.