C# ile Sütun Başlıklarıyla birlikte DataGridView'i Excel'e Aktarma

Excel ile Kolon Başlıklarıyla Bir DataGridView'i C#'ta Nasıl Dışa Aktarırsınız?

Windows Forms DataGridView kontrolünden Excel formatına veri dışa aktarma, yaygın bir gereksinimdir, ancak geliştiriciler genellikle sinir bozucu bir duvarla karşılaşır: dışa aktarılan dosya kolon başlıklarını içermez. Kolon başlıklarıyla DataGridView'i Excel'e dışa aktarmanız gerektiğinde, çözüm tüm verilerinizi ve formatlama ayarlarınızı güvenilir bir şekilde korumalıdır. Microsoft Office Interop'u kullanan geleneksel yaklaşımlar yavaş, kırılgan olabilir ve kodu çalıştıran her makinede MS Excel kurulu olmasını gerektirir.

IronXL bu sorunu temiz bir şekilde çözer. Bu bir .NET Excel kütüphanesidir, Office bağımlılığı olmadan Excel dosyalarını okur, oluşturur ve yazar. Bu eğitim, kolon başlıklarını, veri türlerini, boş hücreleri ve kullanıcı dostu dosya kaydetmeyi sadece birkaç satır kodla ele alan eksiksiz bir dışa aktarma çözümüne sizi götürür.

Sonunda, tüm kolon başlıklarını sağlam tutarak bir DataGridView'i bir XLSX dosyasına dışa aktaran çalışan bir Windows Forms buton işleyiciniz olacak.

Bir .NET Projesinde Kütüphane Nasıl Kurulur?

Visual Studio'da NuGet Paket Yöneticisi Konsolunu açın ve aşağıdaki komutlardan birini çalıştırın. Paket NuGet Galerisi'nde listelenmiştir ve .NET Standard 2.0 ve üzerini hedefler, bu nedenle modern .NET projeleri ile çalışır.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

Kurulumdan sonra, form dosyanızın üst kısmına gerekli ad alanlarını ekleyin:

using IronXL;
using System;
using System.Data;
using System.Windows.Forms;

using IronXL;
using System;
using System.Data;
using System.Windows.Forms;

Imports IronXL
Imports System
Imports System.Data
Imports System.Windows.Forms

Bu ithalatlar, dışa aktarma işlemi için gereken IronXL'in Excel fonksiyonelliği, DataTable işlemleri ve Windows Forms kontrollerine erişim sağlar.

Örnek Verilerle Bir DataGridView Nasıl Kurulur?

Visual Studio'da bir Windows Forms Uygulaması oluşturarak başlayın. Tasarımcı aracılığıyla ana forma dataGridView1 adında bir DataGridView ve btnExport adında bir Buton ekleyin. Ardından form yüklendiğinde tabloyu doldurun:

using System;
using System.Data;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        DataTable dt = new DataTable();

        // Define columns -- these names become Excel headers
        dt.Columns.Add("Product ID", typeof(int));
        dt.Columns.Add("Product Name", typeof(string));
        dt.Columns.Add("Price", typeof(decimal));
        dt.Columns.Add("Stock Quantity", typeof(int));

        // Add sample rows
        dt.Rows.Add(1001, "Laptop", 999.99m, 15);
        dt.Rows.Add(1002, "Mouse", 29.99m, 50);
        dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
        dt.Rows.Add(1004, "Monitor", 299.99m, 12);
        dt.Rows.Add(1005, "Headphones", 89.99m, 25);

        // Bind data to the grid
        dataGridView1.DataSource = dt;
    }
}

using System;
using System.Data;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        DataTable dt = new DataTable();

        // Define columns -- these names become Excel headers
        dt.Columns.Add("Product ID", typeof(int));
        dt.Columns.Add("Product Name", typeof(string));
        dt.Columns.Add("Price", typeof(decimal));
        dt.Columns.Add("Stock Quantity", typeof(int));

        // Add sample rows
        dt.Rows.Add(1001, "Laptop", 999.99m, 15);
        dt.Rows.Add(1002, "Mouse", 29.99m, 50);
        dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
        dt.Rows.Add(1004, "Monitor", 299.99m, 12);
        dt.Rows.Add(1005, "Headphones", 89.99m, 25);

        // Bind data to the grid
        dataGridView1.DataSource = dt;
    }
}

Imports System
Imports System.Data
Imports System.Windows.Forms

Public Partial Class Form1
    Inherits Form

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        Dim dt As New DataTable()

        ' Define columns -- these names become Excel headers
        dt.Columns.Add("Product ID", GetType(Integer))
        dt.Columns.Add("Product Name", GetType(String))
        dt.Columns.Add("Price", GetType(Decimal))
        dt.Columns.Add("Stock Quantity", GetType(Integer))

        ' Add sample rows
        dt.Rows.Add(1001, "Laptop", 999.99D, 15)
        dt.Rows.Add(1002, "Mouse", 29.99D, 50)
        dt.Rows.Add(1003, "Keyboard", 79.99D, 30)
        dt.Rows.Add(1004, "Monitor", 299.99D, 12)
        dt.Rows.Add(1005, "Headphones", 89.99D, 25)

        ' Bind data to the grid
        dataGridView1.DataSource = dt
    End Sub
End Class

dt.Columns.Add(...) çağrılarında tanımlanan sütun adları, dışa aktarılmış Excel dosyasında başlık satırı olacaktır. Burada herhangi bir veri kaynağını kullanabilirsiniz: bir veri tabanı sorgu sonucu, bir CSV içe aktarma veya bir DataTable olarak saklanan bir API yanıtı, gösterilen dışa aktarma koduyla aynı şekilde çalışır. DataTable yaklaşımı özellikle kullanışlıdır çünkü DataGridView, her türlü IList veya IBindingList kabul eden bir DataSource özelliği sunar, yani aynı dışa aktarma kodu, bağlama senaryolarının her birinde değiştirilmeden kullanılabilir.

DataGridView'iniz bir SqlDataAdapter kullanarak bir veritabanından dolduruluyorsa, DataTable zaten tipli sütunlar içerir. Bu tipli değerleri ToString() çağırmak yerine SetCellValue 'a geçirmek, Excel çıktısında sayısal sütunların sayısallığını korur, bu da herhangi bir raporlama veya özet tablo kullanımı için önemlidir.

Bu, tüm veriyle doldurulmuş bir DataGridView oluşturur:

Daha gelişmiş veri bağlama senaryoları için, Microsoft'un DataGridView veri bağlama üzerine belgelendirmesi ek örnekler sağlar.

Kolon Başlıklarını Saklarken DataGridView Excel'e Nasıl Dışa Aktarılır?

Dışa aktarma yöntemi, her DataGridView sütununun HeaderText özelliğinden sütun başlıklarını okur ve bunları çalışma sayfasının 0. satırına yazar. Veri satırları satır 1'den itibaren devam eder. Bu yöntemi btnExport tıklama olayına bağlayın:

private void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");

        // Write column headers to row 0
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
        }

        // Write data rows starting at row 1
        for (int row = 0; row < dataGridView1.Rows.Count; row++)
        {
            // Skip the placeholder new-row at the bottom of the grid
            if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
                continue;

            for (int col = 0; col < dataGridView1.Columns.Count; col++)
            {
                var cellValue = dataGridView1.Rows[row].Cells[col].Value;
                if (cellValue != null)
                {
                    worksheet.SetCellValue(row + 1, col, cellValue.ToString());
                }
            }
        }

        // Prompt the user to choose a save location
        using SaveFileDialog saveFileDialog = new SaveFileDialog
        {
            Filter = "Excel Files|*.xlsx",
            FileName = "DataGridView_Export.xlsx"
        };

        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
                       MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

private void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");

        // Write column headers to row 0
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
        }

        // Write data rows starting at row 1
        for (int row = 0; row < dataGridView1.Rows.Count; row++)
        {
            // Skip the placeholder new-row at the bottom of the grid
            if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
                continue;

            for (int col = 0; col < dataGridView1.Columns.Count; col++)
            {
                var cellValue = dataGridView1.Rows[row].Cells[col].Value;
                if (cellValue != null)
                {
                    worksheet.SetCellValue(row + 1, col, cellValue.ToString());
                }
            }
        }

        // Prompt the user to choose a save location
        using SaveFileDialog saveFileDialog = new SaveFileDialog
        {
            Filter = "Excel Files|*.xlsx",
            FileName = "DataGridView_Export.xlsx"
        };

        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
                       MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

Private Sub btnExport_Click(sender As Object, e As EventArgs)
    Try
        ' Create a new Excel workbook in XLSX format
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim worksheet As WorkSheet = workbook.CreateWorkSheet("Exported Data")

        ' Write column headers to row 0
        For col As Integer = 0 To dataGridView1.Columns.Count - 1
            worksheet.SetCellValue(0, col, dataGridView1.Columns(col).HeaderText)
        Next

        ' Write data rows starting at row 1
        For row As Integer = 0 To dataGridView1.Rows.Count - 1
            ' Skip the placeholder new-row at the bottom of the grid
            If dataGridView1.AllowUserToAddRows AndAlso row = dataGridView1.Rows.Count - 1 Then
                Continue For
            End If

            For col As Integer = 0 To dataGridView1.Columns.Count - 1
                Dim cellValue = dataGridView1.Rows(row).Cells(col).Value
                If cellValue IsNot Nothing Then
                    worksheet.SetCellValue(row + 1, col, cellValue.ToString())
                End If
            Next
        Next

        ' Prompt the user to choose a save location
        Using saveFileDialog As New SaveFileDialog With {
            .Filter = "Excel Files|*.xlsx",
            .FileName = "DataGridView_Export.xlsx"
        }
            If saveFileDialog.ShowDialog() = DialogResult.OK Then
                workbook.SaveAs(saveFileDialog.FileName)
                MessageBox.Show("Export completed successfully!", "Success",
                                MessageBoxButtons.OK, MessageBoxIcon.Information)
            End If
        End Using
    Catch ex As Exception
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
                       MessageBoxButtons.OK, MessageBoxIcon.Error)
    End Try
End Sub

Yaygın Kenar Durumları Dışa Aktarım Sırasında Nasıl Yönetilir?

Gerçek dünya verileri nadiren bir örnek veri seti kadar temiz görünür. Karşılaşmanız muhtemel senaryolar ve bunların nasıl ele alınacağı aşağıda verilmiştir.

if (cellValue is int intVal)
    worksheet.SetCellValue(row + 1, col, intVal);
else if (cellValue is decimal decVal)
    worksheet.SetCellValue(row + 1, col, (double)decVal);
else
    worksheet.SetCellValue(row + 1, col, cellValue?.ToString() ?? string.Empty);

if (cellValue is int intVal)
    worksheet.SetCellValue(row + 1, col, intVal);
else if (cellValue is decimal decVal)
    worksheet.SetCellValue(row + 1, col, (double)decVal);
else
    worksheet.SetCellValue(row + 1, col, cellValue?.ToString() ?? string.Empty);

If TypeOf cellValue Is Integer Then
    Dim intVal As Integer = CType(cellValue, Integer)
    worksheet.SetCellValue(row + 1, col, intVal)
ElseIf TypeOf cellValue Is Decimal Then
    Dim decVal As Decimal = CType(cellValue, Decimal)
    worksheet.SetCellValue(row + 1, col, CDbl(decVal))
Else
    worksheet.SetCellValue(row + 1, col, If(cellValue?.ToString(), String.Empty))
End If

Başlıca Dışa Aktarım Yaklaşımları Nasıl Karşılaştırılır?

Bir kütüphaneye kesin karar vermeden önce, en yaygın yöntemler arasındaki değiş-tokuşları anlamak faydalıdır.

Interop tabanlı çözümler, sunucuya Excel kurulu olmasını gerektirir, bu hem lisanslama hem de dağıtım karmaşıklığıdır. OpenXml SDK güçlü ancak düşük seviyeli -- başlık satırı yazmak, XML yapıları manuel olarak inşa etmeyi gerektirir. IronXL ve ClosedXML her ikisi de daha yüksek seviyede API'ler sunar, ancak IronXL'in WorkBook ve WorkSheet modeli, geliştiricilerin zaten elektronik tablolar hakkında düşündüklerine yakın bir şekilde haritalar.

CSV Yerine XLSX'e Nasıl Dışa Aktarılır?

Bir CSV dosyasına ihtiyaç duyduğunuzda aynı dışa aktarma paterni geçerlidir. Dosya formatını ve uzantısını değiştirin:

WorkBook csvWorkbook = WorkBook.Create(ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkbook.CreateWorkSheet("Data");

// Headers and data loops remain identical

using SaveFileDialog dialog = new SaveFileDialog
{
    Filter = "CSV Files|*.csv",
    FileName = "DataGridView_Export.csv"
};

if (dialog.ShowDialog() == DialogResult.OK)
    csvWorkbook.SaveAs(dialog.FileName);

WorkBook csvWorkbook = WorkBook.Create(ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkbook.CreateWorkSheet("Data");

// Headers and data loops remain identical

using SaveFileDialog dialog = new SaveFileDialog
{
    Filter = "CSV Files|*.csv",
    FileName = "DataGridView_Export.csv"
};

if (dialog.ShowDialog() == DialogResult.OK)
    csvWorkbook.SaveAs(dialog.FileName);

Imports System.Windows.Forms

Dim csvWorkbook As WorkBook = WorkBook.Create(ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkbook.CreateWorkSheet("Data")

' Headers and data loops remain identical

Using dialog As New SaveFileDialog With {
    .Filter = "CSV Files|*.csv",
    .FileName = "DataGridView_Export.csv"
}
    If dialog.ShowDialog() = DialogResult.OK Then
        csvWorkbook.SaveAs(dialog.FileName)
    End If
End Using

Yeniden düzenleme sistemi XLSX desteklemiyorsa veya dosya boyutu çok büyük veri setleri için bir endişe ise, CSV dışa aktarıma ihtiyaç duyulabilir.

Dışa Aktarılan Dosyadaki Başlık Satırı Nasıl Stilize Edilir?

Dışa aktarılan veri, başlık satırı gözle görülür bir şekilde farklı olduğunda daha okunabilir. IronXL, başlık değerlerini yazdıktan sonra kalın metin, arka plan rengi ve yazı tipi boyutu uygulamanıza izin veren hücre stil verme seçenekleri sağlar.

// Write headers and apply bold styling
for (int col = 0; col < dataGridView1.Columns.Count; col++)
{
    string cellAddress = worksheet.GetCellAddress(0, col);
    worksheet[cellAddress].Value = dataGridView1.Columns[col].HeaderText;
    worksheet[cellAddress].Style.Font.Bold = true;
    worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
    worksheet[cellAddress].Style.Font.FontColor = "#FFFFFF";
}

// Write headers and apply bold styling
for (int col = 0; col < dataGridView1.Columns.Count; col++)
{
    string cellAddress = worksheet.GetCellAddress(0, col);
    worksheet[cellAddress].Value = dataGridView1.Columns[col].HeaderText;
    worksheet[cellAddress].Style.Font.Bold = true;
    worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
    worksheet[cellAddress].Style.Font.FontColor = "#FFFFFF";
}

' Write headers and apply bold styling
For col As Integer = 0 To dataGridView1.Columns.Count - 1
    Dim cellAddress As String = worksheet.GetCellAddress(0, col)
    worksheet(cellAddress).Value = dataGridView1.Columns(col).HeaderText
    worksheet(cellAddress).Style.Font.Bold = True
    worksheet(cellAddress).Style.SetBackgroundColor("#4472C4")
    worksheet(cellAddress).Style.Font.FontColor = "#FFFFFF"
Next col

Stilize edilmiş bir başlık satırı, alıcının manuel olarak formatlama uygulama gereksinimi olmadan, dışarı aktarılan dosyanın hemen raporlama için kullanılabilir olmasını sağlar. Tüm stil özelliklerinin tam listesini görmek için, IronXL hücre stil verme referansına bakın.

Ücretsiz Deneme ile Nasıl Başlarsınız?

IronXL, bu makalede gösterilen dışa aktarma iş akışları dahil, tüm özellikleri denemenizi sağlayan ücretsiz bir deneme sunar. Yukarıda gösterilen herhangi bir NuGet komutu ile paketi kurun, IronXL lisanslama sayfasında bir deneme anahtarı oluşturun ve ilk kütüphane çağrınızdan önce uygulamanıza ayarlayın:

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Imports IronXl

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Deneme tam işlevsel Excel dosyaları üretir ve hangi özelliklerin kullanılabilir olduğunu kısıtlamaz. Üretim dağıtımı için, lisanslama seçenekleri tek geliştiricileri, ekipleri ve telif ücretsiz yeniden dağıtımı kapsar.

İlgili dışa aktarma senaryoları için, IronXL'in DataTable'ları doğrudan Excel'e dışa aktarmayı, Excel dosyalarını DataGridView'lere okumayı ve dışarı aktarılan verilerden grafikler oluşturmayı nasıl ele aldığını keşfedin.