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

Blazor Projenizi Ayarlama

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 App" şablonunu seçin. Projenize ad verin ve "Oluştur"a tıklayın.

Projeniz oluşturulduğunda, Pages klasörünü açın ve Index.razor dosyasını bulun. Bu, Blazor bileşenlerinin dosya yüklemeleri ve dönüşümleri ele alacak şekilde eklendiği ve kodlandığı yerdir.

IronXL Kurulumu

Kod yazmaya başlamadan önce, IronXL kütüphanesinin kurulması gereklidir. Visual Studio'da Package Manager Console'u 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 başlamaya hazırsınız!

Dosya Yükleme Bileşeni Oluşturma

Öncelikle, kullanıcıların mevcut bir Excel dosyasını yüklemelerine olanak tanıyan temel bir dosya yükleme bileşeni oluşturun. Ardından, InputFile bileşeni Microsoft.AspNetCore.Components.Forms ad alanından eklenir. Aşağıdaki kodu "@page """ satırının altında Index.razor dosyanıza 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 dönüşümünün durumunu görüntülemek için bir düğme ve bir mesaj alanı ile tamamlanmış dosya yükleme bileşenini ayarlar. accept özniteliği InputFile bileşeni üzerinde kabul edilen dosya formatlarını belirtir.

Dosya Dönüşüm Kodunu Yazma

Şimdi, dosya yükleme ve dönüşüm sürecini yöneten kodu yazalım. Bu görevi başarmak için IronXL, Blazor ve C#'ın birleşimi kullanılacak. IronXL'yi bir CSV'yi Excel dosyasına dönüştürmek için kullanabilirsiniz.

Aşağıdaki kodu daha önce eklediğiniz div öğesinin 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, bir Excel elektronik tablosu InputFile bileşeni kullanılarak yüklendiğinde tetiklenecek olan OnInputFileChange adlı özel bir yöntem 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 bir CSV dosyası olarak kaydeder. Dönüştürmenin durumu sayfadaki mesaj alanında gösterilir.

Kod Analizi

Öncelikle, tam koda bir göz atalım:

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

1. Bir dosya yüklendiğinde, OnInputFileChange yöntemi tetiklenir ve ona bir InputFileChangeEventArgs nesnesi iletilir. Bu nesne, yüklenen dosya hakkında, adı ve boyutu gibi, bilgi 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 düzgün bir şekilde serbest bırakılmasını sağlar.
4. Yüklenen dosyanın içeriğini bellek akışına eşzamanlı olarak kopyalamak için await anahtar kelimesini kullanın. Bu, dosya okunurken uygulamanın duyarlı kalmasını sağlar.
5. Sonraki adımda, bellek akışının içeriğini bir WorkBook nesnesine yüklemek için WorkBook.Load yöntemi kullanılır. Bu nesne, sayfaları, hücreleri ve verileri dahil olmak üzere tüm Excel çalışma kitabını temsil eder.
6. Ardından, dönüştürülmüş CSV dosyası için bir çıkış dosyası adı belirtin. Bu durumda, "sample.csv" adını kullanıyoruz.
7. Ardından, belirlenen çıkış dosya adı ile çalışma kitabını bir CSV dosyası olarak kaydetmek için WorkBook nesnesinin SaveAsCsv yöntemi kullanılır.
8. Dönüştürme başarılı olursa, tamamlandığını belirten bir mesaj gösterilir. Bir hata oluşursa, istisnayı yakalayın ve bir hata mesajı gösterin.

Uygulamayı Test Etme

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

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

Düğmeyi tıklayın ve yüklemek için bir Excel dosyası seçin. Kabul edilen dosya formatları, InputFile bileşeninin accept özniteliğinde listelenmiştir.

Bir Excel dosyası seçin

Bir dosya seçtikten sonra, uygulama dosyayı okuyacak, IronXL kullanarak CSV formatına dönüştürecek ve dönüştürülmüş dosyayı belirtilen çıkış dosya adıyla kaydedecektir. Dönüştürmenin durumunu ve orijinal dosya adını belirten bir mesaj görmelisiniz.

Dönüştürme durumu

Tebrikler! IronXL kullanarak Excel dosyalarını CSV formatına dönüştürebilen bir Blazor uygulaması başarıyla oluşturdunuz. Aşağıdaki ekran görüntüsü yukarıdaki programın çıktısını göstermektedir.

Çıktı Excel dosyası