1.0 Giriş

En iyi bilinen kütüphanelerden biri olan IronXL, bu makalede .NET teknolojilerinin Microsoft Excel belgeleriyle programlı olarak nasıl etkileşime geçebileceğinin farklı yollarını karşılaştırmak ve kıyaslamak için kullanılacaktır. Ayrıca, Excel elektronik tablolarını okumak, yazmak ve CSV dosyalarına aktarmak için bir ortam oluşturacaktır.

2.0 IronXL

IronXL .NET için, bir C# Excel kütüphanesi, Microsoft Excel belgelerini okumak ve CSV dosyalarına dönüştürmek için kullanılabilir. IronXL, Microsoft Office veya Microsoft.Office.Interop.Excel kurulumuna gerek kalmadan kullanılabilecek bağımsız bir .NET yazılım kütüphanesidir. Çeşitli elektronik tablo formatlarını okuyabilir.

Excel elektronik tablolar, IronXL'ın basit C# API'si sayesinde .NET ortamında kolayca okunabilir, düzenlenebilir ve oluşturulabilir. Xamarin, Linux, macOS, Azure, .NET Core ve .NET Framework, IronXL tarafından tamamen desteklenmektedir.

2.1 IronXL Kütüphanesi Özellikleri

IronXL, hem .NET Core hem de .NET Framework ile çalışan, Excel elektronik tabloları için en mükemmel C# kütüphanelerinden biridir. IronXL, konsol, Windows Forms ve Web Uygulamaları dahil olmak üzere neredeyse tüm .NET Framework'lerini destekler. Windows, macOS ve Linux, IronXL ile uyumludur. Excel dosyalarına IronXL kullanarak hızlı ve kolay bir şekilde erişilebilir. IronXL, XLSX dosyaları, CSV dosyaları, XLS, XSLT, TSV, XLSM ve diğerleri gibi Excel dosya formatlarını okuyabilir. Birçok olasılık arasında veri kümelerini ve veri tablolarını içe aktarma, güncelleme ve dışa aktarma işlevleri bulunmaktadır.

• Hesaplamalar IronXL tarafından Excel elektronik tablosu için oluşturulabilir. Excel sütunları için IronXL, metin, tamsayılar, tarihler, para birimleri, formüller ve yüzdeler gibi geniş bir veri türü yelpazesini destekler. Tarihler, para birimleri, yüzdeler, metin, sayılar, formüller ve diğer Excel sütun veri türleri IronXL tarafından desteklenir.

3.0 .NET Core 6 Projesi Oluşturma

Bu bültenin ilerleyen bölümlerinde, IronXL kütüphanesi ile bir CSV dosyasının ne kadar kolay oluşturulabileceğini göreceksiniz.

Adım 1: Bir CSV dosyası oluşturmak için yeni bir proje başlatın.

Visual Studio'yu açın ve "Dosya" menüsünden "Yeni Proje" seçeneğini seçin.

Açılan diyalog kutusundan ".NET Console Uygulaması" proje şablonlarını seçin ve ardından "İleri"ye tıklayın.

Visual Studio'da yeni bir Console Uygulaması oluşturun

"Proje adı" için istediğiniz adı girebilirsiniz. "Location" bölümünde yeni projenin konumu sağlandıktan sonra, devam etmek için Next düğmesine tıklayın.

Yeni projeyi yapılandırın

.NET Framework seçmek için Çerçeve açılır menüsünü kullanabilirsiniz. Bu durumda, uzun dönem destekli .NET sürümü 6.0'dır. Ardından, Oluştur düğmesine tıklayın.

.NET hedef framework seçimi

IronXL kütüphanesini yükleyin, çünkü sonraki çözüm için gereklidir. Bunu başarmak için Paket Yöneticisi Konsoluna aşağıdaki komutu girin:

Install-Package IronXL.Excel

IronXL paketini yükle

Alternatif olarak, NuGet Paket Yöneticisi'ni kullanarak "IronXL" paketini arayabilirsiniz. Göz At sekmesinde arama kutusuna "IronXL" yazın ve IronXL kütüphanesini arayın. IronXL ile ilgili tüm NuGet paketlerinin bu listesinden, ardından indirilecek gerekli paketi seçin.

NuGet Paket Yöneticisi UI'da IronXL paketini arayın ve kurun

4.0 Verileri CSV dosyasına aktarma

IronXL ile CSV dosyalarına veri tabloları oluşturmak basit ve hızlıdır. Yeni bir CSV dosyasına veri yazmayı kolaylaştırır. İlk adım, aşağıda kod ekran görüntüsünde görüldüğü gibi IronXL ad alanını eklemektir. IronXL sunulduktan sonra, sınıfları ve yöntemleri kodda kullanılabilir.

IronXL ad alanını ekleyin

IronXL, Excel dosyaları oluşturmak için kullanılabilir ve ardından WorkBook nesnelerine dönüştürülür. Nesneler WorkBook sınıfından olduktan sonra, onlarla birkaç farklı şekilde çalışmak mümkündür. Aşağıdaki örnek kaynak kod, bir DataTable bir Excel sayfasına dönüştürerek bir Excel dosyası oluşturur.

using IronXL;
using System.Data;

class Program
{
    static void Main(string[] args)
    {
        ExportToExcel("test.csv");
    }

    // Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    public static void ExportToExcel(string filepath)
    {
        // Create a DataTable and add columns & rows
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animals", typeof(string));
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Leopard");
        table.Rows.Add("Cheetah");
        table.Rows.Add("Hyenas");

        // Create a new workbook and get the default worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLS);
        var worksheet = workbook.DefaultWorkSheet;

        // Add table data to worksheet
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            worksheet["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";");
        
        // Optionally convert workbook to a stream, useful for web applications
        var stream = workbook.ToStream();
    }
}

using IronXL;
using System.Data;

class Program
{
    static void Main(string[] args)
    {
        ExportToExcel("test.csv");
    }

    // Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    public static void ExportToExcel(string filepath)
    {
        // Create a DataTable and add columns & rows
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animals", typeof(string));
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Leopard");
        table.Rows.Add("Cheetah");
        table.Rows.Add("Hyenas");

        // Create a new workbook and get the default worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLS);
        var worksheet = workbook.DefaultWorkSheet;

        // Add table data to worksheet
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            worksheet["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";");
        
        // Optionally convert workbook to a stream, useful for web applications
        var stream = workbook.ToStream();
    }
}

Imports IronXL
Imports System.Data

Module Program
    Sub Main(args As String())
        ExportToExcel("test.csv")
    End Sub

    ' Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    Public Sub ExportToExcel(filepath As String)
        ' Create a DataTable and add columns & rows
        Dim table As New DataTable()
        table.Columns.Add("DataSet_Animals", GetType(String))
        table.Rows.Add("Lion")
        table.Rows.Add("Tiger")
        table.Rows.Add("Leopard")
        table.Rows.Add("Cheetah")
        table.Rows.Add("Hyenas")

        ' Create a new workbook and get the default worksheet
        Dim workbook = WorkBook.Create(ExcelFileFormat.XLS)
        Dim worksheet = workbook.DefaultWorkSheet

        ' Add table data to worksheet
        Dim rowCount As Integer = 1
        For Each row As DataRow In table.Rows
            worksheet("A" & rowCount).Value = row(0).ToString()
            rowCount += 1
        Next

        ' Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";")

        ' Optionally convert workbook to a stream, useful for web applications
        Dim stream = workbook.ToStream()
    End Sub
End Module

Imports IronXL
Imports System.Data

Module Program
    Sub Main(args As String())
        ExportToExcel("test.csv")
    End Sub

    ' Method to export a DataTable to an Excel sheet which is then saved as a CSV file
    Public Sub ExportToExcel(filepath As String)
        ' Create a DataTable and add columns & rows
        Dim table As New DataTable()
        table.Columns.Add("DataSet_Animals", GetType(String))
        table.Rows.Add("Lion")
        table.Rows.Add("Tiger")
        table.Rows.Add("Leopard")
        table.Rows.Add("Cheetah")
        table.Rows.Add("Hyenas")

        ' Create a new workbook and get the default worksheet
        Dim workbook = WorkBook.Create(ExcelFileFormat.XLS)
        Dim worksheet = workbook.DefaultWorkSheet

        ' Add table data to worksheet
        Dim rowCount As Integer = 1
        For Each row As DataRow In table.Rows
            worksheet("A" & rowCount).Value = row(0).ToString()
            rowCount += 1
        Next

        ' Save worksheet data to a CSV file
        workbook.SaveAsCsv(filepath, ";")

        ' Optionally convert workbook to a stream, useful for web applications
        Dim stream = workbook.ToStream()
    End Sub
End Module

Yukarıdaki CSV örneği, DataTable'nin bir CSV dosyasına nasıl aktarılacağını gösterir. Bir DataTable kurulmuşsa, yani sütun başlıkları oluşturulmuşsa ve ilk sütun kurulduktan sonra, satırlar tek tek eklenir. DataTable nesnesine satırlar ve sütunlar eklendikten sonra WorkBook nesnesi oluşturulur. WorkBook nesnesi, başka bir yere kaydedilebilecek bir Excel sayfasına veri eklemek için kullanılır. Bir sonraki adım, çalışma kitabı nesnesine bağlı olan WorkSheet nesnesini başlatmaktır.

Değeri çalışma sayfasına eklemeden önce, foreach döngüsü ile DataTable içindeki her değer okunur. SaveAsCsv fonksiyonu, tüm veriler çalışma sayfasına geçirildikten sonra, dosya adı parametre olarak verilerek CSV dosyası olarak kaydetmek için kullanılır. Bir ayırıcı, gerekli olduğu durumlarda, isteğe bağlı bir argüman olarak kullanılabilir. Kütüphane, verilerin bir CSV dosyasına yazılmasına yardımcı olur. Not Defteri kullanarak Microsoft Excel dışında CSV dosyalarını okumak için başka bir yol daha vardır. Ayrıca, Save yöntemi aynı veriyi belirtilen dosya formatında kaydetmek için kullanılır.

Excel dosyasını dışa aktar test.csv

Yukarıda çalıştırılan kod örneğinin çıktısı bulunmaktadır. Veri tablosundaki her bir bilgi, ekran görüntüsündeki yeni oluşturulan Excel sayfasına ayrı ayrı eklenmiştir. Alternatif olarak, istemci tarafından indirilebilecek dosyaları döndürmek için Web Uygulamasının bir parçası olarak da bir akışa dönüştürülebilir.

DataTable'dan Excel'e veri aktarma hakkında daha fazla bilgi için lütfen bu eğitim sayfasını kontrol edin.

Verileri Excel'e aktarma hakkında daha fazla bilgi edinmek için lütfen bu adım adım öğreticiye bakın.

5.0 Sonuç

IronXL, en yaygın kullanılan Excel araçları arasında yer alır. Başka herhangi bir harici kütüphaneye bağlı değildir. Bu, bağımsızdır ve Microsoft Excel'in yüklü olmasına gerek duymaz. Ayrıca, çeşitli kanallar aracılığıyla çalışır.

Tüm programatik olarak uygulanan Microsoft Excel dökümanı ile ilgili işlemler için, IronXL kapsamlı bir çözüm sunar. Formülleri hesaplama, dizgileri veya sayıları sıralama, kırpma, ekleme, bulma ve değiştirme, birleştirme ve birleştirmeyi kaldırma, dosyaları kaydetme ve daha fazlası mümkündür. Elektronik tablo verilerini doğrulamanın yanı sıra, hücre veri türlerini de belirleyebilirsiniz. Bu, Excel verileriyle çalışmayı kolaylaştırır ve dosyaları okumanıza ve yazmanıza olanak tanır.

IronXL, kullanıcıların tüm harika özelliklerini ücretsiz olarak denemelerine ve test etmelerine olanak tanıyan bir ücretsiz deneme lisansı sunar.

Başlatıldığında, IronXL $999 için kullanılabilir. Kullanıcılar, güncellemeler ve ürün desteği almak için bir yıllık abonelik ücreti ödemeyi de tercih edebilir. IronXL, ekstra bir ücret karşılığında sınırsız yeniden dağıtım için güvenlik sağlar. Daha kesin fiyatlandırma verilerini incelemek için lütfen IronXL'nin lisans sayfasını ziyaret edin.