Mesaj ikonu
Altbilgi içeriğine atla
  1. Iron Software
  2. IronXL Blog
  3. IronXL kullanarak
  4. Excel Interop Dışa Aktarma
IRONXL KULLANARAK

Interop ve IronXL'i Kullanarak C# Dilinde DataTable'ı Excel'e Nasıl Aktarılır

Jordi Bardia
Jordi Bardia
Güncellendi:

DataTable'ın Excel'e Dışa Aktarılması Neden .NET Geliştiricileri İçin Önemlidir?

Veritabanı ya da uygulamadan bir Excel dosyasına veri aktarmak, bilgiyi verimli bir şekilde analiz etmek, görselleştirmek ve paylaşmak isteyen organizasyonlar için temel bir gerekliliktir. Excel dosyaları, kullanıcı dostu arayüzleri ile geniş çapta tanınır ve kullanıcıların veriyle etkileşimde bulunmasını ve yorumlamasını kolaylaştırır. Veri kümelerini .xlsx formatına çevirerek, geliştiriciler, alıcının teknik geçmişine bakılmaksızın verilerin erişilebilir ve iyi yapılandırılmış kalmasını sağlar.

.NET geliştiricileri için iki yaygın yaklaşım mevcuttur: Microsoft Office Interop ve IronXL gibi özel Excel kütüphaneleri. Bu kılavuz, çalışan C# kod örnekleriyle her iki yöntemi de ele alır, avantaj ve dezavantajları karşılaştırır ve üretim uygulamaları için her bir yaklaşımın ne zaman anlamlı olduğunu açıklar.

Interop ve IronXL Arasındaki Temel Farklılıklar Nelerdir?

Koda dalmadan önce, bu iki yaklaşım arasındaki temel farkları anlamak, herhangi bir proje için doğru seçimi yapmanıza yardımcı olur. Karşılaştırma, teknik mimari, dağıtım gereklilikleri ve DataTable'dan Excel'e dışa aktarma senaryolarıyla ilgili pratik geliştirme deneyimini kapsar.

C#'da Excel Dışa Aktarımı için Microsoft Office Interop ve IronXL karşılaştırması
Özellik Microsoft Office Interop IronXL
Ofis Kurulumu Gereklidir Evet -- Microsoft Excel kurulmalıdır Hayır -- bağımsız kütüphane
Sunucu Tarafı Desteği Microsoft tarafından önerilmez Tam destekli
Platform Desteği Sadece Windows Windows, Linux, macOS, Azure
.NET Core / .NET 5+ Desteği Sınırlı Tam destek (.NET 6, 7, 8, 9, 10)
Kaynak Yönetimi COM nesnesi temizliği gerektirir Standart .NET bırakma
Kurulum Yöntemi COM referansı + Office kurulumu NuGet paketi
İşleme Modeli Tek iş parçacıklı daire (STA) İş parçacığına güvenli işlemler
Büyük Veri Kümesi Bellek yoğun işlemler Verimlilik dosya tabanlı yaklaşımı
Desteklenen Dosya Formatları XLSX, XLS, CSV XLSX, XLS, CSV, JSON, XML
Lisanslama Office lisansı gerektirir Ticari lisans mevcut

Mimari fark temeldir: Excel Interop, Microsoft Excel uygulamasını COM aracılığıyla kendisi otomatikleştirirken, IronXL herhangi bir harici işlemi başlatmadan Excel dosya formatlarını doğrudan okur ve yazar. Bu fark, bellek kullanımından dağıtım karmaşıklığına kadar her şeyi etkiler.

Excel İhracatı İçin IronXL Nasıl Kurulur?

NuGet ile IronXL kurmak sadece birkaç saniye sürer. Ek bir yazılım, Office kurulumu veya sistem yapılandırması gerekmemektedir. Bu kütüphane, Windows, Linux, ve macOS üzerinde, Azure Uygulama Hizmetleri, Azure Fonksiyonları ve konteyner örnekleri de dahil olmak üzere anında çalışır.

NuGet Paket Yöneticisi Konsolu'nu açın ve çalıştırın:

Install-Package IronXL
dotnet add package IronXL
Install-Package IronXL
dotnet add package IronXL
SHELL

IronXL, .NET Framework 4.6.2+ ve tüm modern .NET sürümlerini .NET 10'a kadar destekler. Kurulduktan sonra, dosyanızın üst kısmına using IronXL; ekleyin ve dışa aktarmaya hazır olun.

C# Kullanarak Interop ile DataTable Excel'e Nasıl Dışa Aktarılır?

Geleneksel yaklaşım, Excel'i doğrudan otomatikleştirmek için Microsoft.Office.Interop.Excel ad alanını kullanır. Bu yöntem, kodun çalışacağı makinada Microsoft Excel'in kurulu olmasını gerektirir.

Interop için Gereksinimler

Interop kullanmadan önce, doğrulayın ki:

  1. Microsoft Excel geliştirme ve dağıtım makinelerinde kurulu olmalıdır.
  2. Visual Studio'da "Microsoft Excel Object Library" için bir COM referansı eklenmiştir.
  3. Microsoft.Office.Interop.Excel ad alanı projenize dahil edilmiştir.

Interop Dışa Aktarma Kodu

Aşağıdaki kod, C# içinde üst seviye ifadelerle Microsoft Office Interop kullanılarak bir DataTable Excel dosyasına nasıl dışa aktarılacağını göstermektedir.

using Microsoft.Office.Interop.Excel;
using System.Data;
using System.Runtime.InteropServices;

// Create a sample DataTable with employee data
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Initialize Excel Application object
Application excelApp = new Application
{
    Visible = false,
    DisplayAlerts = false
};

Workbook workbook = excelApp.Workbooks.Add();
Worksheet worksheet = (Worksheet)workbook.ActiveSheet;

try
{
    // Write column headers to the first row
    for (int i = 0; i < dt.Columns.Count; i++)
    {
        worksheet.Cells[1, i + 1] = dt.Columns[i].ColumnName;
    }

    // Write data rows starting from row 2
    for (int i = 0; i < dt.Rows.Count; i++)
    {
        for (int j = 0; j < dt.Columns.Count; j++)
        {
            worksheet.Cells[i + 2, j + 1] = dt.Rows[i][j].ToString();
        }
    }

    string filePath = @"C:\Reports\EmployeeReport_Interop.xlsx";
    workbook.SaveAs(filePath);
    Console.WriteLine("Excel file created using Interop.");
}
catch (Exception ex)
{
    Console.WriteLine("Error: " + ex.Message);
}
finally
{
    // Always release COM objects to prevent orphaned Excel processes
    workbook.Close();
    excelApp.Quit();
    Marshal.ReleaseComObject(worksheet);
    Marshal.ReleaseComObject(workbook);
    Marshal.ReleaseComObject(excelApp);
}
using Microsoft.Office.Interop.Excel;
using System.Data;
using System.Runtime.InteropServices;

// Create a sample DataTable with employee data
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Initialize Excel Application object
Application excelApp = new Application
{
    Visible = false,
    DisplayAlerts = false
};

Workbook workbook = excelApp.Workbooks.Add();
Worksheet worksheet = (Worksheet)workbook.ActiveSheet;

try
{
    // Write column headers to the first row
    for (int i = 0; i < dt.Columns.Count; i++)
    {
        worksheet.Cells[1, i + 1] = dt.Columns[i].ColumnName;
    }

    // Write data rows starting from row 2
    for (int i = 0; i < dt.Rows.Count; i++)
    {
        for (int j = 0; j < dt.Columns.Count; j++)
        {
            worksheet.Cells[i + 2, j + 1] = dt.Rows[i][j].ToString();
        }
    }

    string filePath = @"C:\Reports\EmployeeReport_Interop.xlsx";
    workbook.SaveAs(filePath);
    Console.WriteLine("Excel file created using Interop.");
}
catch (Exception ex)
{
    Console.WriteLine("Error: " + ex.Message);
}
finally
{
    // Always release COM objects to prevent orphaned Excel processes
    workbook.Close();
    excelApp.Quit();
    Marshal.ReleaseComObject(worksheet);
    Marshal.ReleaseComObject(workbook);
    Marshal.ReleaseComObject(excelApp);
}
Imports Microsoft.Office.Interop.Excel
Imports System.Data
Imports System.Runtime.InteropServices

' Create a sample DataTable with employee data
Dim dt As New DataTable("Employees")
dt.Columns.Add("EmployeeID", GetType(Integer))
dt.Columns.Add("Name", GetType(String))
dt.Columns.Add("Department", GetType(String))
dt.Columns.Add("Salary", GetType(Decimal))

dt.Rows.Add(1, "John Smith", "Engineering", 75000)
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000)
dt.Rows.Add(3, "Michael Chen", "Finance", 70000)
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000)

' Initialize Excel Application object
Dim excelApp As New Application With {
    .Visible = False,
    .DisplayAlerts = False
}

Dim workbook As Workbook = excelApp.Workbooks.Add()
Dim worksheet As Worksheet = CType(workbook.ActiveSheet, Worksheet)

Try
    ' Write column headers to the first row
    For i As Integer = 0 To dt.Columns.Count - 1
        worksheet.Cells(1, i + 1) = dt.Columns(i).ColumnName
    Next

    ' Write data rows starting from row 2
    For i As Integer = 0 To dt.Rows.Count - 1
        For j As Integer = 0 To dt.Columns.Count - 1
            worksheet.Cells(i + 2, j + 1) = dt.Rows(i)(j).ToString()
        Next
    Next

    Dim filePath As String = "C:\Reports\EmployeeReport_Interop.xlsx"
    workbook.SaveAs(filePath)
    Console.WriteLine("Excel file created using Interop.")
Catch ex As Exception
    Console.WriteLine("Error: " & ex.Message)
Finally
    ' Always release COM objects to prevent orphaned Excel processes
    workbook.Close()
    excelApp.Quit()
    Marshal.ReleaseComObject(worksheet)
    Marshal.ReleaseComObject(workbook)
    Marshal.ReleaseComObject(excelApp)
End Try
$vbLabelText   $csharpLabel

Application nesnesi, Excel sürecini temsil eder. Visible = false ayarı, arkaplan işlemleri için hayati öneme sahip olan işleme sırasında Excel'in ekranda açılmasını engeller. DisplayAlerts = false ayarı, otomatikleştirilmiş iş akışlarını kesintiye uğratacak diyalog kutularını bastırır.

finally bloğu isteğe bağlı değildir -- her COM nesnesinin Marshal.ReleaseComObject kullanılarak açıkça serbest bırakılması gerekir. Bu adımın atlanması, Görev Yöneticisinde bellek tüketen ve sonunda sunucuyu istikrarsız hale getiren sahipsiz Excel işlemleri bırakır. Bu temizleme deseni, Interop'u web uygulamaları ve hizmetleri için uygunsuz hale getiren bilinen bir sıkıntı noktasıdır.

IronXL Kullanarak DataTable Excel'e Nasıl Dışa Aktarılır?

IronXL, herhangi bir Office kurulumu olmadan çalışan modern bir alternatif sunar. Kütüphane, Excel dosyalarını doğrudan okur ve yazar, bu da onu sunucu ortamları, bulut dağıtımları ve platformlar arası uygulamalar için ideal hale getirir. Ek API detayları için tam IronXL dökümantasyonunu inceleyin.

IronXL Dışa Aktarma Kodu

Aşağıdaki kod, üst seviye ifadelerle IronXL kutuphanesini kullanarak bir DataTable Excel dosyasına nasıl dönüştüreceğinizi göstermektedir.

using IronXL;
using System.Data;

// Create a sample DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Create a new Excel workbook
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Employees");

// Write column headers to row 0
for (int i = 0; i < dt.Columns.Count; i++)
{
    sheet.SetCellValue(0, i, dt.Columns[i].ColumnName);
}

// Export DataTable rows to Excel cells
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

string filePath = @"C:\Reports\EmployeeReport_IronXL.xlsx";
workbook.SaveAs(filePath);
Console.WriteLine("Excel file created using IronXL.");
using IronXL;
using System.Data;

// Create a sample DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Create a new Excel workbook
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Employees");

// Write column headers to row 0
for (int i = 0; i < dt.Columns.Count; i++)
{
    sheet.SetCellValue(0, i, dt.Columns[i].ColumnName);
}

// Export DataTable rows to Excel cells
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

string filePath = @"C:\Reports\EmployeeReport_IronXL.xlsx";
workbook.SaveAs(filePath);
Console.WriteLine("Excel file created using IronXL.");
Imports IronXL
Imports System.Data

' Create a sample DataTable
Dim dt As New DataTable("Employees")
dt.Columns.Add("EmployeeID", GetType(Integer))
dt.Columns.Add("Name", GetType(String))
dt.Columns.Add("Department", GetType(String))
dt.Columns.Add("Salary", GetType(Decimal))

dt.Rows.Add(1, "John Smith", "Engineering", 75000)
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000)
dt.Rows.Add(3, "Michael Chen", "Finance", 70000)
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000)

' Create a new Excel workbook
Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Employees")

' Write column headers to row 0
For i As Integer = 0 To dt.Columns.Count - 1
    sheet.SetCellValue(0, i, dt.Columns(i).ColumnName)
Next

' Export DataTable rows to Excel cells
For i As Integer = 0 To dt.Rows.Count - 1
    For j As Integer = 0 To dt.Columns.Count - 1
        sheet.SetCellValue(i + 1, j, dt.Rows(i)(j))
    Next
Next

Dim filePath As String = "C:\Reports\EmployeeReport_IronXL.xlsx"
workbook.SaveAs(filePath)
Console.WriteLine("Excel file created using IronXL.")
$vbLabelText   $csharpLabel

IronXL yaklaşımı, benzer bir mantıksal yapıyı izler ancak daha temiz bir sözdizimi ile ve COM karmaşıklığı olmadan. WorkBook.Create metodu, belirtilen formatta yeni bir çalışma kitabı başlatır -- ExcelFileFormat.XLSX, Excel 2007 ve sonrası ile uyumlu modern Office Open XML dosyaları üretir. Kütüphane ayrıca eski sistemler için XLS formatını da destekler.

SetCellValue, standart .NET geleneklerine uyan 0 tabanlı indeksler kullanır, bu da indeks sistemleri arasında dönüştürme yapılırken yaygın olarak ortaya çıkan bir-birden-fazla hatalarını azaltır. Metod, tip dönüştürmesini otomatik olarak ele alır: tamsayı, string, ondalık ve DateTime değerleri uygun Excel hücre tipleri ile yazılır.

Temizlik kodunun tamamen yokluğuna dikkat edin. IronXL nesneleri, çöp toplayıcının otomatik olarak yönettiği standart .NET yönetilen nesneleridir. Yönetilmesi gereken yetim süreçler veya COM referans sayımı riski yoktur.

Interop ve IronXL Kullanarak C# İçinde DataTable Nasıl Excel'e Aktarılır: Görsel 1 - Excel Çıktısı

Interop ve IronXL Kullanarak C# İçinde DataTable Nasıl Excel'e Aktarılır: Görsel 2 - Konsol Çıktısı

Çalışma kitabı oluşturma hakkında daha fazla ayrıntı için IronXL çalışma kitabı oluşturma kılavuzuna bakın.

Yeniden Kullanılabilir Bir İhracat Yöntemini Nasıl Oluşturabilirsiniz?

Üretim uygulamaları, herhangi bir DataTable Excel dosyasına dışa aktarabilecek yeniden kullanılabilir bir metoda sıklıkla ihtiyaç duyar. Aşağıdaki örnek, dışa aktarma mantığını kapsayan, null değerleri ele alabilen ve çıkış dizinini eğer mevcut değilse otomatik olarak oluşturan bir yardımcıyı göstermektedir. Daha fazla desen için IronXL örnekler sayfasına bakın.

Yeniden Kullanılabilir IronXL İhracat Yardımcısı

using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;

// --- ExcelExporter helper ---

bool ExportToExcel(DataTable dt, string filePath)
{
    if (dt == null || dt.Rows.Count == 0)
        return false;

    try
    {
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet sheet = workbook.CreateWorkSheet(dt.TableName ?? "Sheet1");

        // Bold headers in the first row
        for (int i = 0; i < dt.Columns.Count; i++)
        {
            var cell = sheet.GetCellAt(0, i);
            cell.Value = dt.Columns[i].ColumnName;
            cell.Style.Font.Bold = true;
        }

        // Data rows
        for (int i = 0; i < dt.Rows.Count; i++)
        {
            for (int j = 0; j < dt.Columns.Count; j++)
            {
                var value = dt.Rows[i][j];
                sheet.SetCellValue(
                    i + 1, j,
                    (value == DBNull.Value || value == null) ? "" : value
                );
            }
        }

        FileInfo fileInfo = new FileInfo(filePath);
        if (!fileInfo.Directory!.Exists)
            fileInfo.Directory.Create();

        workbook.SaveAs(filePath);
        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine("Export failed: " + ex.Message);
        return false;
    }
}

// --- Usage ---

DataTable employees = new DataTable("Employees");
employees.Columns.Add("EmployeeID", typeof(int));
employees.Columns.Add("Name", typeof(string));
employees.Columns.Add("Department", typeof(string));
employees.Rows.Add(1, "John Smith", "Engineering");
employees.Rows.Add(2, "Sarah Johnson", "Marketing");

bool success = ExportToExcel(employees, @"C:\Reports\Export.xlsx");
Console.WriteLine(success ? "Export completed." : "Export failed.");
using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;

// --- ExcelExporter helper ---

bool ExportToExcel(DataTable dt, string filePath)
{
    if (dt == null || dt.Rows.Count == 0)
        return false;

    try
    {
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet sheet = workbook.CreateWorkSheet(dt.TableName ?? "Sheet1");

        // Bold headers in the first row
        for (int i = 0; i < dt.Columns.Count; i++)
        {
            var cell = sheet.GetCellAt(0, i);
            cell.Value = dt.Columns[i].ColumnName;
            cell.Style.Font.Bold = true;
        }

        // Data rows
        for (int i = 0; i < dt.Rows.Count; i++)
        {
            for (int j = 0; j < dt.Columns.Count; j++)
            {
                var value = dt.Rows[i][j];
                sheet.SetCellValue(
                    i + 1, j,
                    (value == DBNull.Value || value == null) ? "" : value
                );
            }
        }

        FileInfo fileInfo = new FileInfo(filePath);
        if (!fileInfo.Directory!.Exists)
            fileInfo.Directory.Create();

        workbook.SaveAs(filePath);
        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine("Export failed: " + ex.Message);
        return false;
    }
}

// --- Usage ---

DataTable employees = new DataTable("Employees");
employees.Columns.Add("EmployeeID", typeof(int));
employees.Columns.Add("Name", typeof(string));
employees.Columns.Add("Department", typeof(string));
employees.Rows.Add(1, "John Smith", "Engineering");
employees.Rows.Add(2, "Sarah Johnson", "Marketing");

bool success = ExportToExcel(employees, @"C:\Reports\Export.xlsx");
Console.WriteLine(success ? "Export completed." : "Export failed.");
Imports IronXL
Imports IronXl.Styles
Imports System
Imports System.Data
Imports System.IO

' --- ExcelExporter helper ---

Function ExportToExcel(dt As DataTable, filePath As String) As Boolean
    If dt Is Nothing OrElse dt.Rows.Count = 0 Then
        Return False
    End If

    Try
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim sheet As WorkSheet = workbook.CreateWorkSheet(If(dt.TableName, "Sheet1"))

        ' Bold headers in the first row
        For i As Integer = 0 To dt.Columns.Count - 1
            Dim cell = sheet.GetCellAt(0, i)
            cell.Value = dt.Columns(i).ColumnName
            cell.Style.Font.Bold = True
        Next

        ' Data rows
        For i As Integer = 0 To dt.Rows.Count - 1
            For j As Integer = 0 To dt.Columns.Count - 1
                Dim value = dt.Rows(i)(j)
                sheet.SetCellValue(i + 1, j, If(value Is DBNull.Value OrElse value Is Nothing, "", value))
            Next
        Next

        Dim fileInfo As New FileInfo(filePath)
        If Not fileInfo.Directory.Exists Then
            fileInfo.Directory.Create()
        End If

        workbook.SaveAs(filePath)
        Return True
    Catch ex As Exception
        Console.WriteLine("Export failed: " & ex.Message)
        Return False
    End Try
End Function

' --- Usage ---

Dim employees As New DataTable("Employees")
employees.Columns.Add("EmployeeID", GetType(Integer))
employees.Columns.Add("Name", GetType(String))
employees.Columns.Add("Department", GetType(String))
employees.Rows.Add(1, "John Smith", "Engineering")
employees.Rows.Add(2, "Sarah Johnson", "Marketing")

Dim success As Boolean = ExportToExcel(employees, "C:\Reports\Export.xlsx")
Console.WriteLine(If(success, "Export completed.", "Export failed."))
$vbLabelText   $csharpLabel

ExportToExcel yardımcısı, herhangi bir DataTable ve bir dosya yolu string'ini kabul eder, dışa aktarma başarısız olursa veya tablo boşsa false döndürür. Eksik değerleri hücreleri yazmadan önce DBNull.Value kontrol ederek sorunsuz bir şekilde ele alır. Dizin oluşturma adımı, yeni klasör yollarına planlanan dışa aktarmaların kesintiye uğramasını engeller -- yeni ortamlara dağıtılırken yaygın bir üretim sorunu.

Kalın başlıklar, hiçbir ek konfigürasyon gerektirmeyen profesyonel görünümlü bir çıktı üreten cell.Style.Font.Bold = true kullanılarak uygulanır. Desen, kolayca genişletilebilir: kurumsal raporlama standartlarına uygun olarak arka plan renkleri, kenarlıklar veya sütun genişliği otomatik uygunluk ekleyin.

Büyük veri kümeleriyle çalışmak için IronXL performans kılavuzu bellek tahsisini minimize eden toplu yazma stratejilerini kapsar. Kutuphane, bir DataSet -- ilişkili DataTable nesneler topluluğu -- bir çalışma kitabında birden fazla çalışma sayfasına aktarmayı da destekler, bu da çok sayfalı raporlar için kullanışlıdır.

Her İki Yaklaşım da Hücre Biçimlendirmeyi Nasıl Yönetiyor?

Profesyonel Excel ihracatları genellikle biçimlendirme gerektirir: koyu başlıklar, renkli hücreler, kenarlıklar ve sayı formatları. Her iki kütüphane de stil desteği sunar, ancak uygulama açısından önemli ölçüde fark vardır, özellikle de sözcük fazlalığı ve güvenilirlik bakımından.

IronXL ile Biçimlendirme

using IronXL;
using IronXl.Styles;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Product", typeof(string));
dt.Columns.Add("Revenue", typeof(decimal));
dt.Rows.Add("Widget A", 15000.50m);
dt.Rows.Add("Widget B", 22500.75m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write headers with light blue background and bold font
for (int i = 0; i < dt.Columns.Count; i++)
{
    var cell = sheet.GetCellAt(0, i);
    cell.Value = dt.Columns[i].ColumnName;
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#ADD8E6");
    cell.Style.BottomBorder.SetColor("#000000");
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Write data rows
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

workbook.SaveAs(@"C:\Reports\FormattedReport_IronXL.xlsx");
Console.WriteLine("Formatted Excel file created.");
using IronXL;
using IronXl.Styles;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Product", typeof(string));
dt.Columns.Add("Revenue", typeof(decimal));
dt.Rows.Add("Widget A", 15000.50m);
dt.Rows.Add("Widget B", 22500.75m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write headers with light blue background and bold font
for (int i = 0; i < dt.Columns.Count; i++)
{
    var cell = sheet.GetCellAt(0, i);
    cell.Value = dt.Columns[i].ColumnName;
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#ADD8E6");
    cell.Style.BottomBorder.SetColor("#000000");
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Write data rows
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

workbook.SaveAs(@"C:\Reports\FormattedReport_IronXL.xlsx");
Console.WriteLine("Formatted Excel file created.");
Imports IronXL
Imports IronXl.Styles
Imports System.Data

Dim dt As New DataTable("Sales")
dt.Columns.Add("Product", GetType(String))
dt.Columns.Add("Revenue", GetType(Decimal))
dt.Rows.Add("Widget A", 15000.50D)
dt.Rows.Add("Widget B", 22500.75D)

Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.CreateWorkSheet("Sales")

' Write headers with light blue background and bold font
For i As Integer = 0 To dt.Columns.Count - 1
    Dim cell = sheet.GetCellAt(0, i)
    cell.Value = dt.Columns(i).ColumnName
    cell.Style.Font.Bold = True
    cell.Style.SetBackgroundColor("#ADD8E6")
    cell.Style.BottomBorder.SetColor("#000000")
    cell.Style.BottomBorder.Type = BorderType.Thin
Next

' Write data rows
For i As Integer = 0 To dt.Rows.Count - 1
    For j As Integer = 0 To dt.Columns.Count - 1
        sheet.SetCellValue(i + 1, j, dt.Rows(i)(j))
    Next
Next

workbook.SaveAs("C:\Reports\FormattedReport_IronXL.xlsx")
Console.WriteLine("Formatted Excel file created.")
$vbLabelText   $csharpLabel

IronXL'nın stil API'si temiz bir nesne modeli kullanır. Renk değerleri, standart #ADD8E6 (açık mavi) gibi hex kodlarını kabul eder, bu da kurumsal marka rengine uygunluğu sağlamak için renk sistemleri arasında dönüştürme gerektirmeden işlemleri kolaylaştırır. BorderType.Thin ve BorderType.Thick, numaralandırma aramaları gerektirmeyen standart kenarlık senaryolarını kapsar.

Interop ve IronXL Kullanarak C# İçinde DataTable Nasıl Excel'e Aktarılır: Görsel 3 - IronXL ile Biçimlendirilmiş Çıktı

Tüm stil seçenekleri, sayı formatları, koşullu biçimlendirme ve hücre birleştirme dahil için IronXL hücre stil kılavuzunu ve kenarlık ve hizalama dökümantasyonunu inceleyin.

Interop Biçimlendirme Karmaşıklığı

Interop karşılığı bireysel Range nesnelerine erişir ve Font.Bold, Interior.Color ve Borders.LineStyle gibi özellikleri ayarlar. Her bir özellik erişimi bir COM süreçler arası çağrı olup, ekstra yük ekler ve Excel yanıt vermez hale gelirse istisna olasılığını artırır. Renk değerleri System.Drawing.ColorTranslator.ToOle dönüştürmesi gerektirir ve her bir stil bloğu, standart COM temizlik zincirini takip etmelidir -- en az üç Marshal.ReleaseComObject çağrısı.

Bu sözcük fazlalığı, koşullu biçimlendirme, sütun genişlikleri veya sayı formatları büyük çalışma sayfalarında uygulandığında problemler oluşturur. IronXL, aynı senaryoları daha az kod satırıyla ve bir çökme sonrası Excel süreçlerini çalışan bırakma riski olmadan yönetir.

.NET'te Excel İhracatı İçin En İyi Uygulamalar Nelerdir?

İhracat rutinleri boyunca tutarlı uygulamaları izlemek hataları azaltır, bakımı geliştirir ve kodunuzu test etmeyi ve dağıtmayı kolaylaştırır.

Adlandırma ve Yol Sözleşmeleri

Dışa aktarılan dosyalar için tutarlı bir adlandırma kuralı kullanın: {ReportName}_{Timestamp}.xlsx. Tahmin edilebilir dosya adları, otomatik temizliği ve arşivlemeyi sadeleştirir. Çıkış dizinini sert şekilde kodlamak yerine uygulama yapılandırmasında saklayın -- bu, yeni ortamlara dağıtılırken DirectoryNotFoundException engeller.

Hata Yönetimi

Tüm ihracat mantığını try-catch bloklarında sarın ve başarısızlığı teşhis etmek için yeterli bağlamla istisnaları kaydedin. Planlı ihracatlar için, istisna atmaktan ziyade bir sonuç nesnesi döndürmeyi düşünün, böylece çağıran hizmet çökmeden tekrar deneyebilir veya operatörleri uyarabilir. Yukarıdaki ExportToExcel yardımcısı bu modeli, bool dönüş değerine sahip olarak göstermektedir.

Büyük Veri Kümesi Yönetimi

50.000'den fazla satırlık veri kümeleri için, bellek baskısını önlemek için verileri dilimler halinde akıtın. IronXL, gelişimli yazma işlemlerini destekler ve OpenXML SDK, çok büyük dosyalar için düşük düzeyli akış sağlar. Masaüstü uygulamaları için Interop'u büyük veri kümeleri için tamamen kullanmaktan kaçının -- bellek içi modeli, büyük ölçekte önemli yavaşlamalara neden olur.

Platformlar Arası Dağıtım

Uygulama, Linux veya macOS üzerinde çalıştırıldığında -- örneğin Docker konteynırlarında veya Azure Linux Uygulama Hizmetlerinde -- IronXL tek geçerli seçimdir. Interop, Excel COM sunucusuna bağımlı olduğu için Windows dışında çalışmaz. Tüm bağımlılıkların hedef çalıştırma zamanında mevcut olduğundan emin olmak için .NET çapraz platform dağıtım kılavuzunu kullanın.

Test Etme

İhracat mantığı için birim testleri, çıktı dosyasının varlığını, beklenen satır sayısını içerdiğini ve doğru sütun adlarını kullandığını doğrulamalıdır. IronXL'ın WorkBook.Load metodu, testlerde dışa aktarılan dosyaları Excel'i başlatmadan okumayı kolaylaştırır. Örnekler için IronXL okuma kılavuzuna bakın.

Her Yaklaşımı Seçerken Ne Zaman Tercih Etmelisiniz?

Doğru seçim, projenin özel gereksinimlerine, dağıtım ortamına ve uzun vadeli bakım düşüncelerine bağlıdır.

Microsoft Office Excel Interop'u tercih etmeniz gereken durumlar:

  • Interop'a zaten bağımlı olan eski sistemlerle çalışırken ve geçiş imkansız olduğunda.
  • Makrolar, döner tablolar veya grafik otomasyonu gibi ileri düzey Excel özellikleri, tam Excel uygulama nesne modelinin gerekli olduğu durumlar.
  • Kullanıcıların Microsoft Excel yüklü olduğu ve uygulamanın etkileşimli olarak çalıştığı masaüstü uygulamaları geliştirirken.
  • Dağıtım ortamının tamamen kontrol edildiği, sadece Windows platformunda ve Office lisanslarının zaten mevcut olduğu durumlar.
  • Karmaşık gömülü formüller veya VBA kodu içeren mevcut Excel şablonlarını otomatikleştirirken.

IronXL'yi şu durumlarda seçin:

  • Web uygulamaları, REST API'leri veya arka plan servisleri geliştirirken, Excel dosyası ihracı üreten.
  • Azure Uygulama Hizmetleri, AWS Lambda veya Docker konteynırları gibi bulut ortamlarına dağıtılırken.
  • Windows, Linux veya macOS dağıtımları için çapraz platform desteği gerektiğinde.
  • Interop desteğinin sınırlı olduğu .NET Framework 4.6.2+ veya modern .NET sürümleriyle çalışırken.
  • COM temizlik endişeleri olmadan güvenilir kaynak yönetimi gerektiğinde.
  • Üretim sunucularında Office lisanslama bağımlılıklarını önlemek istendiğinde.
  • İzole Excel dosya üretiminin gerekli olduğu çok kiracılı uygulamalar geliştirirken.
  • COM arabulucu iletişimi ek yükü olmadan büyük veri kümelerini verimli bir şekilde işlemek gerektiğinde.
  • XLSX, XLS, CSV, JSON ve XML dahil olmak üzere birden fazla formata ihracat gerektiğinde.

Daha fazla senaryo için IronXL öğreticilerini inceleyin; bunlara mevcut Excel dosyalarını okuma, formüllerle çalışmak ve birden çok çalışma sayfasını yönetmek dahildir.

Sıradaki Adımlarınız Neler?

Bir DataTable Excel dosyasına dışa aktarmak, iş verilerini ele alan .NET uygulamaları için temel bir gerekliliktir. Kaynak bir veritabanı sorgusu, çoklu ilişkili tabloya sahip bir DataSet veya dinamik olarak oluşturulmuş bir bellek içi koleksiyon olsun, doğru kitaplık seçimi dağıtım esnekliğini ve uzun süreli sürdürülebilirliği belirler.

Microsoft Office Excel Interop, geliştiricilere yıllarca hizmet etmiştir, ancak Office kurulumu bağımlılığı, COM karmaşıklığı, desteklenmeyen sunucu senaryoları ve kaynak yönetimi sorunları, modern uygulama geliştirme için giderek daha pratik olmaktan uzaklaştırmaktadır.

IronXL, bu sınırlamalara hitap eden daha temiz bir alternatif sunar. Basit bir NuGet kurulumu, Windows, Linux ve macOS'u kapsayan çapraz platform desteği ve .NET geleneklerini izleyen API'lar ile, dağıtım sıkıntılarını ve Excel Interop çözümlerini etkileyen kaynak yönetimi tuzaklarını ortadan kaldırır.

Başlamak için IronXL'yi NuGet'ten yükleyin, yukarıdaki kod örneklerinden birini kopyalayın ve bir test DataTable hızlı bir dışa aktarma yapın. IronXL hızlı başlangıç kılavuzu, birkaç dakika içinde en yaygın senaryoları kapsar. Üretime hazır olduğunuzda, takım boyutunuza ve dağıtım modelinize uygun seçeneği bulmak için IronXL lisanslama sayfasını gözden geçirin. Daha fazla keşfi için, tam IronXL API referansını ve topluluk örnekleri için IronXL GitHub deposunu inceleyin.

Sıkça Sorulan Sorular

C# içinde DataTable'ları dışa aktarırken Excel Interop'a kıyasla IronXL kullanmanın ana avantajı nedir?

IronXL, C# içinde Excel'in sunucuda kurulu olmasına gerek kalmadan DataTable'ları Excel'e daha basit ve daha verimli bir şekilde dışa aktarma imkanı sağlar.

IronXL, Excel'e dışa aktarırken büyük DataTable'ları işleyebilir mi?

Evet, IronXL performans için optimize edilmiştir ve büyük DataTable'ları hızlı ve güvenilir bir şekilde Excel dosyalarına dışa aktarma yeteneğine sahiptir.

Veri dışa aktarmak için IronXL kullanmak için Microsoft Excel'in yüklü olması gerekiyor mu?

Hayır, IronXL, Microsoft Excel gerektirmez, bu yüzden sunucu tarafı uygulamalar için idealdir.

IronXL, DataTable'ları Interop'a kıyasla dışa aktarma sürecini nasıl basitleştirir?

IronXL, Interop ile ilişkili karmaşık kurulum ve bağımlılıkları ortadan kaldırarak, DataTable'ları dışa aktarmak için basit bir API sağlar.

IronXL, .NET core ile Excel'e DataTable'ları dışa aktarmak için uyumlu mu?

Evet, IronXL tamamen .NET Core ile uyumludur, böylece DataTable'ları çapraz platformu uygulamalarda Excel'e dışa aktarabilirsiniz.

IronXL, DataTable'ları hangi dosya formatlarına dışa aktarabilir?

IronXL, DataTable'ları çeşitli Excel dosya formatlarına, örneğin XLSX, XLS ve CSV'ye dışa aktarabilir.

IronXL, Excel sayfalarının stil ve formatlamasını destekler mi?

Evet, IronXL gelişmiş stil ve formatlama seçeneklerini destekler, bu sayede DataTable'lardan düzenli Excel sayfaları oluşturabilirsiniz.

IronXL'yi C#'ta Excel ile ilgili görevleri otomatikleştirmek için kullanabilir miyim?

Evet, IronXL, DataTable'ları dışa aktarmaktan karmaşık veri analizine kadar geniş bir yelpazede Excel ile ilgili görevleri otomatikleştirmek için kullanılabilir.

IronXL'e yeni olan geliştiriciler için bir öğrenme eğrisi var mı?

IronXL, sezgisel ve öğrenmesi kolay olacak şekilde tasarlanmıştır ve geliştiricilerin hızlı bir başlangıç yapmalarına yardımcı olacak kapsamlı belgeler ve örnekler sunar.

IronXL'i ticari bir projede kullanmanın lisanslama seçenekleri nelerdir?

IronXL, farklı proje ihtiyaçlarına uygun çeşitli lisanslama seçenekleri sunar, bunlar arasında ticari kullanım için süresiz ve abonelik lisansları bulunur.

Jordi Bardia
Jordi Bardia
  Mühendislik takımıyla şimdi sohbet edin
Yazılım Mühendisi
Jordi Python, C# ve C++ konularında en yetkin, Iron Software'deki yeteneklerini kullanmadığı zamanlarda; oyun programlıyor. Ürün testi, ürün geliştirme ve araştırma sorumluluklarını paylaşan Jordi, sürekli ürün gelişimine büyük değer katıyor. Çeşitli deneyimleri onu ...
Daha Fazlasını Oku

İlgili Makaleler

30 günlük deneme → Tam ürün. Sınırlama yok. Kart gerekmez. Ücretsiz Deneme Başlat

Iron Destek Ekibi

Haftanın 5 günü, 24 saat çevrimiçiyiz.
Sohbet
E-posta
Beni Ara