C# Veri Tablosundan Excel'e (Kod Örneği Eğitimi)

IronXL Özellikleri

• IronXL, Windows, Linux ve macOS dahil olmak üzere çeşitli İşletim Sistemlerinde çalışır.
• Neredeyse tüm .NET Çerçeveleri, Konsol, Windows Forms Uygulaması ve Web Uygulaması dahil olmak üzere IronXL tarafından desteklenir.
• IronXL, Excel dosyalarını okumayı kolay ve basit hale getirir.
• IronXL ile, XLSX dosyaları, XLS, CSV, TSV, XLST, XLSM dosyaları gibi Excel dosya formatlarını veri tablolarını dışa aktarma, veri tablolarını dışa aktarma ve Excel dosyası okuma gibi işlemleri çalıştırabiliriz.
• IronXL, XLS, CSV, TSV, JSON, XLSX ve diğerleri dahil olmak üzere çeşitli uzantılarla dosyaları kaydetmemizi ve dışa aktarmamızı sağlar.
• Excel formülleri IronXL tarafından oluşturulabilir.
• Metin, Numaralar, Formüller, Tarihler, Para Birimi, Yüzdeler ve diğer Excel hücre veri formatları IronXL tarafından desteklenir.
• Ayrıca Aralıklar, Sütunlar ve Satır gibi birçok sıralama seçenekleri sunar.
• IronXL'de hücre stillendirmesi yazı tipi, boyut, arka plan deseni, kenarlık ve hizalama gibi özellikleri içerir.
• IronXL kullanarak bir Excel dosyasından veri okuyabilir ve dışa aktarabiliriz.
• IronXL, sunucunuza Excel veya Interop yüklemeyi gerektirmez. IronXL API, Microsoft Office, Interop ve Excel'e göre daha hızlı ve kullanımı daha kolaydır.

1 Visual Studio'da Yeni Bir Proje Oluşturma

IronXL kutuphanesini kullanmak icin Visual Studio'da bir .NET projesi oluşturmamiz gerekiyor. Visual Studio'nun herhangi bir surumunu kullanabilirsiniz, ancak en son surumu kullanmanız önerilir. Gereksinimleriniz dogrultusunda Windows Forms gibi bir uygulama veya farklı proje şablonları oluşturabilirsiniz. Bu eğitim için basitlik açısından Konsol Uygulamasını kullanacağım.

Visual Studio'da yeni bir proje arayüzü oluşturun

Sonraki adımda, proje adı ve projenin konumunu girin.

Yeni proje oluşturma sırasında yapılandırma adımı

Sonra, aşağıdaki çerçeveyi seçin. Bu projede .NET Core 6 kullanacağız.

.Net Framework seçimi kullanıcı arayüzü

Uygulama çözümü oluşturduğunda, kod yazabileceğiniz ve uygulamayı oluşturup/çalıştırabileceğiniz program.cs dosyasını açacaktır.

Yeni projede boş program.cs dosyası

Sonraki adımda, kodu test etmek için kutuphaneyi ekleyebiliriz.

2 IronXL Kutuphanesini Yükleme

IronXL Kutuphanesi dört şekilde indirilebilir ve yüklenebilir.

Bunlar su sekildedir:

• Visual Studio Kullanarak
• Visual Studio Komut Satırı'nı kullanarak.
• NuGet web sitesinden doğrudan indirilebilir.
• IronXL web sitesinden doğrudan indirilebilir.

Install-Package IronXl.Excel

3 IronXL kullanarak Datatable'ı Excel Dosyasına Aktar

IronXL, Az adım ile DataTables'ı kolayca Excel dosyalarına aktarmamıza izin verir.

Öncelikle, aşağıdaki kod ekran görüntüsünde olduğu gibi IronXL'nin ad alanını dahil etmeliyiz. Eklendikten sonra, kodumuzda IronXL sınıflarını ve yöntemlerini kullanabiliriz.

Kütüphaneyi kullanmadan önce IronXL'nin namespace dahil edin

IronXL, Excel dosyaları oluşturmamıza ve bunları çalışma kitabı nesnelerine dönüştürmemize izin verir. Bunları nesnelere dönüştürdükten sonra, çeşitli türde işlemler gerçekleştirebiliriz. Aşağıdaki örnek kodda, bir DataTable'ı Excel çalışma sayfasına dönüştüreceğiz ve ardından bir Excel dosyası oluşturabiliriz.

using System;
using System.Data;
using IronXL;

public class ExcelExporter
{
    /// <summary>
    /// Exports a DataTable to an Excel file using IronXL.
    /// </summary>
    /// <param name="filePath">The file path where the Excel file will be saved.</param>
    public static void ExportToExcel(string filePath)
    {
        // Creating a DataTable with a single column
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animal", typeof(string));

        // Adding some rows to the DataTable
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Cat");
        table.Rows.Add("Goat");
        table.Rows.Add("Panther");
        table.Rows.Add("Fox");
        table.Rows.Add("Cheetah");

        // Creating a new Excel Workbook
        WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);

        // Accessing the default worksheet
        WorkSheet ws = wb.DefaultWorkSheet;

        // Iterating through the DataTable rows
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            // Adding each DataRow's first column value to the corresponding cell in the worksheet
            ws["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Saving the workbook to a CSV file at specified file path with ";" as delimiter
        wb.SaveAsCsv(filePath, ";");
    }
}

using System;
using System.Data;
using IronXL;

public class ExcelExporter
{
    /// <summary>
    /// Exports a DataTable to an Excel file using IronXL.
    /// </summary>
    /// <param name="filePath">The file path where the Excel file will be saved.</param>
    public static void ExportToExcel(string filePath)
    {
        // Creating a DataTable with a single column
        DataTable table = new DataTable();
        table.Columns.Add("DataSet_Animal", typeof(string));

        // Adding some rows to the DataTable
        table.Rows.Add("Lion");
        table.Rows.Add("Tiger");
        table.Rows.Add("Cat");
        table.Rows.Add("Goat");
        table.Rows.Add("Panther");
        table.Rows.Add("Fox");
        table.Rows.Add("Cheetah");

        // Creating a new Excel Workbook
        WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);

        // Accessing the default worksheet
        WorkSheet ws = wb.DefaultWorkSheet;

        // Iterating through the DataTable rows
        int rowCount = 1;
        foreach (DataRow row in table.Rows)
        {
            // Adding each DataRow's first column value to the corresponding cell in the worksheet
            ws["A" + rowCount].Value = row[0].ToString();
            rowCount++;
        }

        // Saving the workbook to a CSV file at specified file path with ";" as delimiter
        wb.SaveAsCsv(filePath, ";");
    }
}

Imports System
Imports System.Data
Imports IronXL

Public Class ExcelExporter
	''' <summary>
	''' Exports a DataTable to an Excel file using IronXL.
	''' </summary>
	''' <param name="filePath">The file path where the Excel file will be saved.</param>
	Public Shared Sub ExportToExcel(ByVal filePath As String)
		' Creating a DataTable with a single column
		Dim table As New DataTable()
		table.Columns.Add("DataSet_Animal", GetType(String))

		' Adding some rows to the DataTable
		table.Rows.Add("Lion")
		table.Rows.Add("Tiger")
		table.Rows.Add("Cat")
		table.Rows.Add("Goat")
		table.Rows.Add("Panther")
		table.Rows.Add("Fox")
		table.Rows.Add("Cheetah")

		' Creating a new Excel Workbook
		Dim wb As WorkBook = WorkBook.Create(ExcelFileFormat.XLS)

		' Accessing the default worksheet
		Dim ws As WorkSheet = wb.DefaultWorkSheet

		' Iterating through the DataTable rows
		Dim rowCount As Integer = 1
		For Each row As DataRow In table.Rows
			' Adding each DataRow's first column value to the corresponding cell in the worksheet
			ws("A" & rowCount).Value = row(0).ToString()
			rowCount += 1
		Next row

		' Saving the workbook to a CSV file at specified file path with ";" as delimiter
		wb.SaveAsCsv(filePath, ";")
	End Sub
End Class

Yukarıdaki kodda, Veri Tablosunu bir Excel dosyasına aktarıyoruz. İlk olarak, bir DataTable oluşturuyoruz ve ardından sütun başlıkları oluşturuyoruz. Sütunları oluşturduktan sonra, satırları birer birer ekliyoruz. Satırlar eklendikten sonra, WorkBook nesnesini oluşturuyoruz. Nesneyi kullanarak verileri Excel sayfasına ekleyebilir ve ardından verileri konuma kaydedebiliriz. Bir çalışma sayfası oluşturmaya imkan veren WorkSheet nesnesini oluşturuyoruz ve ardından bunu WorkBook nesnesine ekleyebiliriz.

Veri Tablosu değerlerini birer birer okumak için bir foreach döngüsü kullanıyoruz ve ardından değeri çalışma sayfasına ekliyoruz. Tüm değerler çalışma sayfasına eklendikten sonra, bunları SaveAsCsv adlı yöntemle bir CSV dosyasına kaydediyoruz — bir parametre olarak ayırıcı ve dosya adını konumla birlikte geçmemiz gerekiyor. Ayırıcı, gerekliyse görmezden gelebileceğimiz bir isteğe bağlı parametredir.

Visual Studio'da tamamlanmış kod

Yukarıda, .NET Core 6'da kullandığımız kodun tam ekran görüntüsü bulunmaktadır.

Sonuç:

Microsoft Excel'de dosya açıldığında elde edilen sonuç

Yukarıda, çalıştırılan örnek kodun sonucu bulunmaktadır. Ekran görüntüsünde, DataTable'da mevcut olan tüm veriler yeni oluşturulan Excel sayfasına birer birer eklenmiştir.

4 Sonuç

IronXL, en yaygın kullanılan Excel kütüphanelerinden biridir. Başka herhangi bir üçüncü taraf kütüphaneye bağlı değildir. Bağımsızdır ve MS Excel'in yüklenmesi gerekmez. Birden çok platformda çalışır. IronXL için giriş fiyatı $799'dan başlıyor. Ayrıca, ürün desteği ve güncellemeleri için bir yıllık ücret seçeneği sunmaktadır. IronXL, ekstra bir maliyetle telif ücretsiz yeniden dağıtım kapsamı sunmaktadır. Fiyat detayları hakkında daha fazla bilgi için, lisans sayfamızı ziyaret edin.