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.
• IronXL neredeyse tüm .NET Çerçevelerini destekler, Konsol, Windows Forms Uygulaması ve Web Uygulaması dahil.
• IronXL, Excel dosyalarını okumayı kolay ve basit hale getirir.
• IronXL ile, veri tablolarını yükleyebilir, düzenleyebilir, dışa aktarabilir, ve veri setlerini dışa aktarabiliriz ve XLSX dosyaları, XLS, CSV, TSV, XLST, XLSM dosyaları ve daha fazlası gibi Excel dosya formatlarını okuyabiliriz.
• IronXL, XLS, CSV, TSV, JSON, XLSX ve diğer uzantılarla dosyaları kaydetmemize ve dışa aktarmamıza olanak tanır.
• IronXL, Excel formülleri oluşturabilir.
• Metin, Sayılar, Formüller, Tarihler, Para Birimi, Yüzdeler ve diğer Excel hücre veri formatları IronXL tarafından desteklenir. Öte yandan, çeşitli sıralama seçenekleri de sağlar, örneğin Aralık, Sütunlar ve Satırlar gibi. IronXL'deki hücre stil ayarlamaları, yazı tipi, boyut, arka plan deseni, kenarlık ve hizalama gibi unsurları içerir. Excel dosyasından veri okumak ve dışa aktarmak için IronXL kullanabiliriz. IronXL, sunucunuzda Excel veya Interop yüklü olmasını gerektirmez. IronXL API'si Microsoft Office, Interop ve Excel'den daha hızlı ve kullanımı daha kolaydır.

1 Visual Studio'da Yeni Bir Proje Oluşturma

IronXL kütüphanesini kullanmak için, Visual Studio'da bir .NET projesi oluşturmalıyız. Visual Studio'nun herhangi bir sürümünü kullanabilirsiniz, ancak en son sürüm önerilmektedir. Gereksinimlerinize bağlı olarak Windows Forms gibi bir uygulama veya farklı proje şablonları oluşturabilirsiniz. Basitlik açısından bu öğretici için Konsol Uygulamasını kullanacağım.

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

Ardından, proje adını ve projenin konumunu girin.

Yeni bir proje oluştururken yapılandırma adımı

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

.NET Framework seçim arayüzü

Uygulama çözümü oluşturduğunda, kodu girebileceğiniz ve uygulamayı derleyip çalıştırabileceğiniz program.cs dosyasını açacaktır.

Yeni projede boş program.cs dosyası

Sonrasında, kodu test etmek için kütüphaneyi ekleyebiliriz.

2 IronXL Kütüphanesini Kurun

IronXL kütüphanesi dört şekilde indirilebilir ve kurulabilir.

Bunlar şunlardır:

• Visual Studio Kullanarak
• Visual Studio Komut Satırını kullanma.
• NuGet web sitesinden doğrudan indirin.
• IronXL web sitesinden doğrudan indirin.

Install-Package IronXL.Excel

3 IronXL Kullanarak Veritabanından Excel Dosyasına Dışa Aktarma

IronXL, DataTables'i Excel dosyalarına kolayca dışa aktarmamıza olanak tanır, bu işlem az sayıda adım gerektirir.

İlk olarak, IronXL'nin isim alanını aşağıdaki kodun ekran görüntüsünde olduğu gibi dahil etmemiz gerekir. Kodu ekledikten sonra, IronXL sınıf ve metodlarını kodumuzda kullanabiliriz.

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

IronXL, Excel dosyaları oluşturmamıza ve bunları çalışma kitabı nesnelerine dönüştürmemize olanak tanır. Nesnelere dönüştürdükten sonra, çeşitli türlerde operasyonlar 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, DataTable'ı bir Excel dosyasına aktarıyoruz. İlk olarak, bir DataTable oluşturuyoruz, ardından sütun başlıklarını yaratıyoruz. Sütunları oluşturduktan sonra, satırları teker teker ekliyoruz. Satırlar eklendiğinde, WorkBook nesnesini oluşturuyoruz. Bu nesneyi kullanarak verileri Excel sayfasına ekleyebilir ve ardından verileri konuma kaydedebiliriz. Bir çalışma sayfası oluşturulmasına olanak tanıyan WorkSheet nesnesini oluşturuyoruz ve ardından bunu WorkBook nesnesine ekleyebiliriz.

DataTable 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, SaveAsCsv adlı yöntemle bunları bir CSV dosyasına kaydediyoruz — ayırıcı ve dosya adı ile konumu bir parametre olarak geçirmemiz gerekiyor. Ayırıcı, gereken bir parametre olmayan ve gerekirse göz ardı edilebilecek bir seçenektir.

Visual Studio'daki tamamlanmış kod

Yukarıda adı geçen, .NET Core 6 üzerinde kullandığımız kodun tam ekran görüntüsüdür.

Sonuç:

Microsoft Excel'de dosyayı açarken elde edilen sonuç

Yukarıda, yürütülen kod örneğinin sonucunu gösterir. Ekran görüntüsünde, DataTable'da mevcut olan tüm veriler tek tek yeni oluşturulan Excel sayfasına 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 kurulmasına gerek yoktur. Birden fazla platformda çalışır. IronXL'nin tanıtım fiyatı $999'den başlar. Ayrıca, ürün desteği ve güncellemeler için bir yıllık ücret seçeneği sunar. IronXL, ek bir maliyetle telif ücretsiz yeniden dağıtım kapsamı sağlar. Fiyat detayları için lisanslama sayfamızı ziyaret edin.