C# Eksportuj DataGridView do Excel z nagłówkami kolumn

Jak wyeksportować DataGridView do Excela wraz z nagłówkami kolumn w języku C#?

Eksportowanie danych z kontrolki DataGridView w Windows Forms do formatu Excel jest częstym wymaganiem, ale programiści często napotykają frustrującą przeszkodę: w eksportowanym pliku brakuje nagłówków kolumn. Jeśli chcesz wyeksportować DataGridView do Excela wraz z nagłówkami kolumn, rozwiązanie musi niezawodnie zachować wszystkie dane i formatowanie. Tradycyjne podejścia wykorzystujące Microsoft Office Interop mogą być powolne, niestabilne i wymagać zainstalowania programu MS Excel na każdym komputerze, na którym uruchamiany jest kod.

IronXL rozwiązuje ten problem w sposób przejrzysty. Jest to biblioteka .NET dla programu Excel, która odczytuje, tworzy i zapisuje pliki Excel bez konieczności korzystania z pakietu Office. Ten samouczek przeprowadzi Cię przez kompletne rozwiązanie do eksportu — takie, które obsługuje nagłówki kolumn, typy danych, komórki null oraz przyjazne dla użytkownika zapisywanie plików za pomocą zaledwie kilku linii kodu.

Na koniec będziesz mieć działający handler przycisku Windows Forms, który eksportuje DataGridView do pliku XLSX z zachowaniem wszystkich nagłówków kolumn.

Jak zainstalować bibliotekę w projekcie .NET?

Otwórz konsolę menedżera pakietów NuGet w programie Visual Studio i uruchom jedno z poniższych poleceń. Pakiet jest dostępny w NuGet Gallery i jest przeznaczony dla .NET Standard 2.0 i nowszych wersji, dzięki czemu działa z każdym nowoczesnym projektem .NET.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

Po instalacji dodaj wymagańe przestrzenie nazw na początku pliku formularza:

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

Te importy zapewniają dostęp do funkcji programu Excel w IronXL, operacji DataTable oraz elementów sterujących Windows Forms niezbędnych do procesu eksportu.

Jak skonfigurować DataGridView z przykładowymi danymi?

Zacznij od utworzenia aplikacji Windows Forms w programie Visual Studio. Dodaj do głównego formularza za pomocą projektanta element DataGridView o nazwie dataGridView1 oraz przycisk o nazwie btnExport. Następnie wypełnij tabelę po załadowaniu formularza:

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

Nazwy kolumn zdefiniowane w wywołaniach dt.Columns.Add(...) staną się wierszem nagłówkowym w eksportowanym pliku Excel. Można tu zastąpić dowolne źródło danych — wynik zapytania do bazy danych, import CSV lub odpowiedź API zapisana jako DataTable działają identycznie z kodem eksportu pokazanym poniżej. Podejście oparte na DataTable jest szczególnie wygodne, ponieważ DataGridView udostępnia właściwość DataSource, która akceptuje dowolny IList lub IBindingList, co oznacza, że ten sam kod eksportu ma zastosowanie w każdym scenariuszu powiązania bez konieczności modyfikacji.

Jeśli DataGridView jest wypełniany z bazy danych przy użyciu SqlDataAdapter, DataTable zawiera już kolumny typu. Przekazanie tych wpisanych wartości do SetCellValue zamiast wywołania na nich ToString() pozwala zachować kolumny liczbowe jako liczbowe w wynikach programu Excel, co ma znaczenie dla wszelkich dalszych raportów lub wykorzystania tabel przestawnych.

Powoduje to utworzenie kontrolki DataGridView wypełnionej wszystkimi danymi:

W przypadku bardziej zaawansowanych scenariuszy powiązania danych dodatkowe przykłady można znaleźć w dokumentacji Microsoftu dotyczącej powiązania danych w DataGridView.

Jak wyeksportować DataGridView do Excela, zachowując nagłówki kolumn?

Metoda eksportu odczytuje nagłówki kolumn z właściwości HeaderText każdej kolumny DataGridView i zapisuje je w wierszu 0 arkusza. Wiersze danych zaczynają się od wiersza 1. Podłącz tę metodę do zdarzenia kliknięcia btnExport:

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

Jak radzisz sobie z typowymi sytuacjami granicznymi podczas eksportu?

Dane z rzeczywistych sytuacji rzadko wyglądają tak przejrzyście jak przykładowy zbiór danych. Oto scenariusze, z którymi najprawdopodobniej się spotkasz, oraz sposoby ich rozwiązania.

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

Jak wypadają w porównaniu główne podejścia do eksportu?

Przed podjęciem decyzji o wyborze biblioteki warto zrozumieć kompromisy między najpopularniejszymi metodami.

Rozwiązania oparte na Interop wymagają zainstalowania programu Excel na serwerze, co wiąże się zarówno z kwestią licencji, jak i złożonością wdrożenia. OpenXml SDK jest potężnym narzędziem, ale działa na niskim poziomie — napisanie wiersza nagłówkowego wymaga ręcznego tworzenia struktur XML. Zarówno IronXL, jak i ClosedXML zapewniają interfejsy API wyższego poziomu, ale model WorkBook i WorkSheet w IronXL ściśle odpowiada sposobowi, w jaki programiści postrzegają arkusze kalkulacyjne.

Jak wyeksportować do pliku CSV zamiast XLSX?

Ten sam wzorzec eksportu ma zastosowanie, gdy potrzebny jest plik CSV zamiast skoroszytu Excel. Zmień format pliku i rozszerzenie:

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

Eksport do formatu CSV jest przydatny, gdy system docelowy nie obsługuje formatu XLSX lub gdy rozmiar pliku stanowi problem w przypadku bardzo dużych zbiorów danych.

Jak sformatować wiersz nagłówka w eksportowanym pliku?

Eksportowane dane są bardziej czytelne, gdy wiersz nagłówka jest wyraźnie wyróżniony. IronXL oferuje opcje stylizacji komórek, które pozwalają zastosować pogrubiony tekst, kolor tła i rozmiar czcionki po wpisaniu wartości nagłówków:

// 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

Stylizowany wiersz nagłówka sprawia, że wyeksportowany plik nadaje się do natychmiastowego wykorzystania w raportach, bez konieczności ręcznego formatowania przez odbiorcę. Pełna lista właściwości stylów znajduje się w dokumentacji dotyczącej stylów komórek IronXL.

Jak rozpocząć korzystanie z bezpłatnej wersji próbnej?

IronXL oferuje bezpłatną wersję próbną, która pozwala przetestować wszystkie funkcje, w tym procesy eksportu przedstawione w tym artykułe. Zainstaluj pakiet za pomocą jednego z poleceń NuGet pokazanych powyżej, wygeneruj klucz próbny na stronie licencyjnej IronXL i ustaw go w swojej aplikacji przed pierwszym wywołaniem biblioteki IronXL:

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

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

Imports IronXl

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

Wersja próbna generuje w pełni funkcjonalne pliki Excel i nie ogranicza dostępnych funkcji. W przypadku wdrożenia produkcyjnego opcje licencyjne obejmują pojedynczych programistów, zespoły oraz redystrybucję bez opłat licencyjnych.

W przypadku powiązanych scenariuszy eksportu sprawdź, jak IronXL radzi sobie z eksportowaniem tabel danych bezpośrednio do Excela, wczytywaniem plików Excel do widoków DataGridView oraz tworzeniem wykresów na podstawie wyeksportowanych danych.