Blazor'da CSV'ye Nasıl Dışa Aktarılır

Blazor Projenizi Kurma

Başlamak için yeni bir Blazor Server projesi oluşturmanız gerekecek. Visual Studio'yu açın, yeni bir proje oluşturun ve "Blazor Server Uygulaması" şablonunu seçin. Projenizi adlandırın ve "Oluştur"a tıklayın.

Projeniz oluşturulduktan sonra, Sayfalar klasörünü açın ve Index.razor dosyasını bulun. Bu, Blazor bileşenlerinin dosya yüklemeleri ve dönüşümleri yönetmek için eklendiği ve kodlandığı yerdir.

IronXL'i Kurma

Kod yazmaya başlamadan önce IronXL kütüphanesinin kurulması gerekir. Visual Studio'daki Paket Yöneticisi Konsolu nu açın ve aşağıdaki komutu çalıştırın:

Install-Package IronXL.Excel

Bu komut, Blazor projenizde IronXL kütüphanesini kuracaktır. Artık kod yazmaya hazırsınız!

Dosya Yükleme Bileşeni Oluşturma

Öncelikle, kullanıcıların mevcut bir Excel dosyasını yüklemesine izin veren temel bir dosya yükleme bileşeni oluşturun. Ardından, InputFile bileşeni Microsoft.AspNetCore.Components.Forms ad alanından eklenir. Index.razor dosyanıza, "@page """ satırının altına aşağıdaki kodu ekleyin:

@using Microsoft.AspNetCore.Components.Forms
@using IronXL
@using System.IO
@using System.Threading.Tasks

<div class="container">
    <h3>File Upload</h3>

    <InputFile class="button" OnChange="@OnInputFileChange" accept=".xls,.xlsx,.xlsm,.xltx,.csv,.tsv" />
    <h3>Selected File: @originalFileName</h3>
    <h3 style="color:bisque">Is File converted: <span>@message</span></h3>
</div>

Bu kod, dosya yükleme bileşenini, butonu ve dosya dönüştürme durumunu göstermek için bir mesaj alanı ile kurar. InputFile bileşenindeki accept niteliği kabul edilen dosya formatlarını belirtir.

Dosya Dönüştürme Kodunu Yazma

Şimdi, dosya yüklemeyi ve dönüştürmeyi yöneten kodu yazalım. Bunu gerçekleştirmek için IronXL, Blazor ve C# kombinasyonu kullanılacaktır. Bir CSV dosyasını Excel dosyasına IronXL kullanarak dönüştürebilirsiniz.

Aşağıdaki kodu daha önce eklediğiniz div ögesinin altına Index.razor dosyanıza ekleyin.

@code {
    private string originalFileName;
    private string message = "";

    private async Task OnInputFileChange(InputFileChangeEventArgs e)
    {
        var file = e.File;
        originalFileName = file.Name;

        try
        {
            // Read the uploaded file into a memory stream
            using var memoryStream = new MemoryStream();
            await file.OpenReadStream().CopyToAsync(memoryStream);

            // Load the workbook using IronXL
            WorkBook workBook = WorkBook.Load(memoryStream);

            // Save the workbook as a CSV file
            string outputPath = "sample.csv";
            workBook.SaveAsCsv(outputPath);

            message = "Conversion completed!";
        }
        catch (Exception ex)
        {
            message = $"An error occurred: {ex.Message}";
        }
    }
}

Bu kod, InputFile bileşeni kullanılarak bir Excel elektronik tablosu yüklendiğinde tetiklenecek olan OnInputFileChange adlı özel bir yöntemi tanımlar; Excel, XLS veya XLSX formatında olabilir. Kod, yüklenen temel Excel dosyasını okur, bir WorkBook nesnesine yükler ve ardından WorkBook dosyasını bir CSV dosyası olarak kaydeder. Dönüşüm durumu sayfadaki mesaj alanında gösterilir.

Kod Çözümlemesi

Öncelikle, tam kodu inceleyin:

@page "/"
@using Microsoft.AspNetCore.Components.Forms
@using IronXL
@using System.IO
@using System.Threading.Tasks

<style>
    body{
        background-color: skyblue
    }
    .container {
        max-width: 800px;
        margin: 0 auto;
        font-family: Arial, sans-serif;
    }

    h3 {
        margin-top: 30px;
        font-size: 30px;
        margin-bottom: 30px;
    }

    .button {
        background-color: #4CAF50;
        border: none;
        color: white;
        padding: 15px 32px;
        text-align: center;
        text-decoration: none;
        display: inline-block;
        font-size: 16px;
        margin: 15px 0;
        cursor: pointer;
    }
    span {
        font-size: 20px;
    }
</style>

<div class="container">
    <h3>File Upload</h3>

    <InputFile class="button" OnChange="@OnInputFileChange" accept=".xls,.xlsx,.xlsm,.xltx,.csv,.tsv" />
    <h3>Selected File: @originalFileName</h3>
    <h3 style="color:bisque">Is File converted: <span>@message</span></h3>
</div>

@code {
    private string originalFileName;
    private string message = "";

    private async Task OnInputFileChange(InputFileChangeEventArgs e)
    {
        var file = e.File;
        originalFileName = file.Name;

        try
        {
            // Read the uploaded file into a memory stream
            using var memoryStream = new MemoryStream();
            await file.OpenReadStream().CopyToAsync(memoryStream);

            // Load the workbook using IronXL
            WorkBook workBook = WorkBook.Load(memoryStream);

            // Save the workbook as a CSV file
            string outputPath = "sample.csv";
            workBook.SaveAsCsv(outputPath);

            message = "Conversion completed!";
        }
        catch (Exception ex)
        {
            message = $"An error occurred: {ex.Message}";
        }
    }
}

Kodu daha da açıklayalım:

1. Bir dosya yüklendiğinde, OnInputFileChange yöntemi tetiklenir ve bu yönteme bir InputFileChangeEventArgs nesnesi iletilir. Bu nesne, yüklenen dosya hakkında, adı ve boyutu gibi bilgiler içerir.
2. Orijinal dosya adını, sayfada göstermek için originalFileName adlı bir değişkende saklayın.
3. Bir try-catch bloğu içinde, yüklenen dosyanın içeriğini okumak için yeni bir MemoryStream nesnesi oluşturun. Using ifadesi, bellek akışının artık ihtiyaç duyulmadığında doğru şekilde bertaraf edilmesini sağlar.
4. Yüklenen dosyanın içeriğini hafıza akışına eş zamanlı kopyalamak için await anahtar kelimesini kullanın. Bu, dosya okunurken uygulamanın duyarlı kalmasını sağlar.
5. Sonraki adımda, hafıza akışının içeriğini bir WorkBook nesnesine yüklemek için WorkBook.Load yöntemini kullanın. Bu nesne, elektronik tablonun tüm sayfalarını, hücrelerini ve verilerini temsil eder.
6. Dönüştürülen CSV dosyası için bir çıkış dosya adı belirtin. Bu durumda, "sample.csv" adını kullanıyoruz.
7. Ardından, WorkBook nesnesinin SaveAsCsv yöntemi kullanılarak çalışma kitabı belirtilen çıktı dosya adıyla bir CSV dosyası olarak kaydedilir.
8. Dönüşüm başarılı olursa, dönüşümün tamamlandığını belirtmek için bir mesaj görüntülenir. Bir hata oluşursa, istisnayı yakalayın ve bir hata mesajı gösterin.

Uygulamayı Test Etme

Blazor uygulamanız tamamlandıktan sonra, onu test etme zamanı! Visual Studio'da uygulamanızı çalıştırmak için F5'e basın. Uygulama çalıştığında, sayfada bir dosya yükleme düğmesi görmelisiniz.

Blazor uygulamasını çalıştırın

Düğmeye tıklayın ve yüklemek için bir Excel dosyası seçin. Kabul edilen dosya formatları, InputFile bileşeninin kabul niteliğinde listelenir.

Bir Excel dosyası seçin

Bir dosya seçtikten sonra, uygulama dosyayı okur, IronXL kullanarak CSV formatına dönüştürür ve belirtilen çıkış dosya adı ile dönüştürülen dosyayı kaydeder. Dönüşümün durumunu ve orijinal dosya adını belirten bir mesaj görmelisiniz.

Dönüşüm durumu

Tebrikler! IronXL kullanarak Blazor'da Excel dosyalarını CSV formatına ihraç edebilecek bir uygulama başarıyla oluşturduk. Yukarıdaki programın çıktısını gösteren ekran görüntüsü aşağıdadır.

Çıkış Excel Dosyası