Eksportowanie danych z DataGridView do pliku Excel wymaga zaledwie kilku linii kodu C# przy użyciu IronXL. Utwórz WorkBook, iteruj przez kolumny i wiersze siatki, zapisz każdą wartość komórki do arkusza, a następnie wywołaj SaveAs, aby wygenerować w pełni sformatowany plik .xlsx — bez potrzeby instalacji Microsoft Office.
Windows Forms to podstawowa biblioteka GUI w ekosystemie .NET, szeroko stosowana do tworzenia aplikacji desktopowych. Kontrolka DataGridView jest jednym z najczęściej używanych komponentów: wyświetla, edytuje i zarządza danymi tabelarycznymi z dowolnego źródła z możliwością wiązania, takiego jak DataTable, wynik zapytania z bazy danych lub lista w pamięci.
Eksportowanie tych danych siatki do programu Excel służy kilku codziennym potrzebom — wysyłaniu raportów do interesariuszy, archiwizowaniu migawek na potrzeby audytu lub przekazywaniu danych do dalszych narzędzi analitycznych. Dwa tradycyjne podejścia to Microsoft Interop Office oraz biblioteki innych producentów. Interop wymaga zainstalowania programu Excel na każdym komputerze, na którym działa aplikacja, co powoduje problemy z cyklem życia obiektów COM i słabą wydajność w środowiskach serwerowych lub chmurowych. Biblioteki takie jak IronXL, ClosedXML i Syncfusion unikają tych problemów, zapisując dane bezpośrednio w formacie plików Open XML bez żadnej zależności od pakietu Office.
W niniejszym przewodniku przedstawiono podejście IronXL w języku C# przeznaczonym dla platformy .NET 10, chociaż IronXL obsługuje platformę .NET Framework 4.6.2 oraz wszystkie nowoczesne wersje Wersji .NET.
Przed napisaniem jakiegokolwiek kodu eksportującego upewnij się, że spełnione są następujące warunki:
DataGridViewOtwórz konsolę menedżera pakietów w Visual Studio i uruchom jedno z poniższych poleceń:
Alternatywnie, kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań, wybierz Zarządzaj pakietami NuGet, wyszukaj IronXL.Excel i kliknij Zainstaluj.
Po zainstalowaniu dodaj dyrektywę using IronXL na początku każdego pliku, który korzysta z funkcji Excela:
using IronXL;
using System.Data;Imports IronXL
Imports System.DataIronXL obsługuje wszystkie popularne formaty arkuszy kalkulacyjnych: XLSX, XLS, CSV i TSV. W niniejszym przewodniku używany jest format XLSX, ponieważ jest to domyślny format w nowoczesnych wersjach programu Excel.
W przykładzie formularz zawiera DataGridView o nazwie DataGridView1 oraz przycisk o nazwie btnExport. Siatka jest wypełniana w zdarzeniu Load formularza rekordami pracowników przechowywanymi w DataTable:
void Form1_Load(object sender, EventArgs e)
{
var dt = new DataTable();
// Define columns with the appropriate .NET type
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));
// Add sample rows
dt.Rows.Add(101, "Sarah Johnson", "Engineering", 85000m);
dt.Rows.Add(102, "Michael Chen", "Marketing", 72000m);
dt.Rows.Add(103, "Emily Davis", "Finance", 91000m);
dt.Rows.Add(104, "James Wilson", "Engineering", 78000m);
DataGridView1.DataSource = dt;
}Option Strict On
Option Infer On
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
Dim dt As New DataTable()
' Define columns with the appropriate .NET type
dt.Columns.Add("EmployeeID", GetType(Integer))
dt.Columns.Add("Name", GetType(String))
dt.Columns.Add("Department", GetType(String))
dt.Columns.Add("Salary", GetType(Decimal))
' Add sample rows
dt.Rows.Add(101, "Sarah Johnson", "Engineering", 85000D)
dt.Rows.Add(102, "Michael Chen", "Marketing", 72000D)
dt.Rows.Add(103, "Emily Davis", "Finance", 91000D)
dt.Rows.Add(104, "James Wilson", "Engineering", 78000D)
DataGridView1.DataSource = dt
End SubKażda kolumna jest zdefiniowana za pomocą konkretnego typu .NET, aby porównania liczbowe i formatowanie działały poprawnie w dalszej części. Właściwość DataSource wiąże DataTable bezpośrednio z DataGridView, a siatka automatycznie renderuje wszystkie wiersze po otwarciu formularza. W środowisku produkcyjnym dane te zazwyczaj pochodzą z zapytania do bazy danych, zestawu wyników ORM lub odpowiedzi REST API, a nie z wartości zakodowanych na stałe.
DataGridView udostępnia swoją zawartość przez dwie kolekcje: Columns (dla metadanych, takich jak HeaderText i indeks kolumny) oraz Rows (dla rzeczywistych danych komórek). Każdy DataGridViewRow zawiera kolekcję Cells indeksowaną przez pozycję kolumny. Właściwość Value każdej komórki zwraca zapakowany obiekt, który musisz rzutować lub konwertować przed zapisem do komórki Excel. Zrozumienie tej hierarchii jest niezbędne do napisania niezawodnej pętli eksportu.
W tle DataTable przechowuje wartości typowane, więc pensja dziesiętna nie wymaga konwersji na ciąg znaków przed zapisem do arkusza IronXL. Metoda SetCellValue IronXL akceptuje przeciążenia string, double, decimal, int, bool i DateTime, co pozwala zachować oryginalny typ danych w pliku wyjściowym.
Logika eksportu znajduje się w procedurze obsługi kliknięcia przycisku. Kod tworzy nowy WorkBook, pobiera domyślny arkusz, zapisuje nagłówki kolumn w pierwszym wierszu, a następnie zapisuje każdy wiersz danych poniżej:
void btnExport_Click(object sender, EventArgs e)
{
var workbook = WorkBook.Create();
var sheet = workbook.DefaultWorkSheet;
// Write column headers to row index 0
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
}
// Write data rows starting at row index 1
for (int row = 0; row < DataGridView1.Rows.Count; row++)
{
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
if (cellValue is not null)
{
sheet.SetCellValue(row + 1, col, cellValue.ToString()!);
}
}
}
string outputPath = "EmployeeData.xlsx";
workbook.SaveAs(outputPath);
MessageBox.Show("Export complete. File saved to: " + outputPath, "Success");
}Private Sub btnExport_Click(sender As Object, e As EventArgs)
Dim workbook = WorkBook.Create()
Dim sheet = workbook.DefaultWorkSheet
' Write column headers to row index 0
For col As Integer = 0 To DataGridView1.Columns.Count - 1
sheet.SetCellValue(0, col, DataGridView1.Columns(col).HeaderText)
Next
' Write data rows starting at row index 1
For row As Integer = 0 To DataGridView1.Rows.Count - 1
For col As Integer = 0 To DataGridView1.Columns.Count - 1
Dim cellValue As Object = DataGridView1.Rows(row).Cells(col).Value
If cellValue IsNot Nothing Then
sheet.SetCellValue(row + 1, col, cellValue.ToString())
End If
Next
Next
Dim outputPath As String = "EmployeeData.xlsx"
workbook.SaveAs(outputPath)
MessageBox.Show("Export complete. File saved to: " & outputPath, "Success")
End SubObiekt WorkBook reprezentuje cały plik Excel w pamięci. DefaultWorkSheet zwraca pierwszy arkusz bez potrzeby tworzenia go jawnie. Pętla zewnętrzna zapisuje tekst nagłówka z HeaderText w wierszu zero. Następnie zagnieżdżona pętla iteruje każdy wiersz danych, sprawdzając, czy nie zawiera wartości null, przed konwersją wartości komórki na ciąg znaków. Przesunięcie row + 1 sprawia, że dane są poniżej wiersza nagłówka. SaveAs zapisuje ukończony skoroszyt jako plik Open XML XLSX na określoną ścieżkę.
Plik wynikowy otwiera się w programie Excel, Arkuszach Google lub dowolnej aplikacji obsługującej format XLSX. Nagłówki kolumn pojawiają się w pierwszym wierszu, a wszystkie wiersze danych następują w tej samej kolejności, w jakiej pojawiły się w DataGridView.
Zwykły zrzut danych jest funkcjonalny, ale nie nadaje się do prezentacji. API stylizacji IronXL pozwala zastosować pogrubione czcionki, kolory tła, kolory tekstu i formaty liczb do dowolnego zakresu komórek przed zapisaniem:
void ExportWithFormatting()
{
var workbook = WorkBook.Create();
var sheet = workbook.DefaultWorkSheet;
// Write column headers
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
}
// Style the header row: bold white text on blue background
var headerRange = sheet.GetRange("A1:D1");
headerRange.Style.Font.Bold = true;
headerRange.Style.SetBackgroundColor("#4472C4");
headerRange.Style.Font.SetColor("#FFFFFF");
// Locate the Salary column index
int salaryColIndex = -1;
for (int i = 0; i < DataGridView1.Columns.Count; i++)
{
if (string.Equals(DataGridView1.Columns[i].HeaderText, "Salary",
StringComparison.OrdinalIgnoreCase))
{
salaryColIndex = i;
break;
}
}
// Write data rows, preserving numeric types
for (int row = 0; row < DataGridView1.Rows.Count; row++)
{
if (DataGridView1.Rows[row].IsNewRow) continue;
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
if (cellValue is null) continue;
int targetRow = row + 1;
if (col == salaryColIndex)
{
// Write salary as a true numeric decimal
if (decimal.TryParse(cellValue.ToString(),
System.Globalization.NumberStyles.Number,
System.Globalization.CultureInfo.InvariantCulture,
out decimal decValue))
{
sheet.SetCellValue(targetRow, col, decValue);
}
else
{
sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
}
}
else
{
sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
}
}
}
// Apply currency format to the salary column data range
var salaryRange = sheet.GetRange("D2:D5");
salaryRange.FormatString = "$#,##0";
workbook.SaveAs("FormattedEmployeeData.xlsx");
}Option Strict On
Option Infer On
Sub ExportWithFormatting()
Dim workbook = WorkBook.Create()
Dim sheet = workbook.DefaultWorkSheet
' Write column headers
For col As Integer = 0 To DataGridView1.Columns.Count - 1
sheet.SetCellValue(0, col, DataGridView1.Columns(col).HeaderText)
Next
' Style the header row: bold white text on blue background
Dim headerRange = sheet.GetRange("A1:D1")
headerRange.Style.Font.Bold = True
headerRange.Style.SetBackgroundColor("#4472C4")
headerRange.Style.Font.SetColor("#FFFFFF")
' Locate the Salary column index
Dim salaryColIndex As Integer = -1
For i As Integer = 0 To DataGridView1.Columns.Count - 1
If String.Equals(DataGridView1.Columns(i).HeaderText, "Salary", StringComparison.OrdinalIgnoreCase) Then
salaryColIndex = i
Exit For
End If
Next
' Write data rows, preserving numeric types
For row As Integer = 0 To DataGridView1.Rows.Count - 1
If DataGridView1.Rows(row).IsNewRow Then Continue For
For col As Integer = 0 To DataGridView1.Columns.Count - 1
Dim cellValue As Object = DataGridView1.Rows(row).Cells(col).Value
If cellValue Is Nothing Then Continue For
Dim targetRow As Integer = row + 1
If col = salaryColIndex Then
' Write salary as a true numeric decimal
Dim decValue As Decimal
If Decimal.TryParse(cellValue.ToString(), Globalization.NumberStyles.Number, Globalization.CultureInfo.InvariantCulture, decValue) Then
sheet.SetCellValue(targetRow, col, decValue)
Else
sheet.SetCellValue(targetRow, col, cellValue.ToString())
End If
Else
sheet.SetCellValue(targetRow, col, cellValue.ToString())
End If
Next
Next
' Apply currency format to the salary column data range
Dim salaryRange = sheet.GetRange("D2:D5")
salaryRange.FormatString = "$#,##0"
workbook.SaveAs("FormattedEmployeeData.xlsx")
End SubMetoda GetRange akceptuje standardową notację Excel (A1:D1) do wyboru ciągłego bloku komórek. Ustawienie Style.Font.Bold, Style.SetBackgroundColor i Style.Font.SetColor stosuje te formaty do każdej komórki w wybranym zakresie. Dla kolumn liczbowych zapisanie wartości jako decimal zamiast ciągu znaków zachowuje typ danych, co oznacza, że Excel może prawidłowo zastosować formatowanie liczby, takie jak $#,##0. Komórki przechowywane jako ciągi znaków nie reagują na kody formatowania liczbowego.
Można rozszerzyć ten wzór, aby zastosować naprzemienny cieńowanie wierszy, automatyczne dopasowanie szerokości kolumn, lub zamrożenie okienek, konsultując się z dokumentacją stylizacji IronXL.
Niektóre procesy wymagają danych wyjściowych w formacie CSV w celu zapewnienia kompatybilności ze starszymi systemami lub lekkimi potokami danych. IronXL obsługuje eksport do formatu CSV bez konieczności wprowadzania dodatkowych zmian w głównym kodzie:
void ExportToCsv()
{
var workbook = WorkBook.Create();
var sheet = workbook.DefaultWorkSheet;
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
}
for (int row = 0; row < DataGridView1.Rows.Count; row++)
{
if (DataGridView1.Rows[row].IsNewRow) continue;
for (int col = 0; col < DataGridView1.Columns.Count; col++)
{
object? cell = DataGridView1.Rows[row].Cells[col].Value;
if (cell is not null)
sheet.SetCellValue(row + 1, col, cell.ToString()!);
}
}
// Saving with a .csv extension produces a comma-separated file
workbook.SaveAs("EmployeeData.csv");
}Sub ExportToCsv()
Dim workbook = WorkBook.Create()
Dim sheet = workbook.DefaultWorkSheet
For col As Integer = 0 To DataGridView1.Columns.Count - 1
sheet.SetCellValue(0, col, DataGridView1.Columns(col).HeaderText)
Next
For row As Integer = 0 To DataGridView1.Rows.Count - 1
If DataGridView1.Rows(row).IsNewRow Then Continue For
For col As Integer = 0 To DataGridView1.Columns.Count - 1
Dim cell As Object = DataGridView1.Rows(row).Cells(col).Value
If cell IsNot Nothing Then
sheet.SetCellValue(row + 1, col, cell.ToString())
End If
Next
Next
' Saving with a .csv extension produces a comma-separated file
workbook.SaveAs("EmployeeData.csv")
End SubJedyną zmianą względem eksportu XLSX jest rozszerzenie pliku przekazane do SaveAs. IronXL wykrywa rozszerzenie i automatycznie serializuje skoroszyt w odpowiednim formacie. Ta spójność oznacza, że logika zapisu danych pozostaje identyczna niezależnie od formatu wyjściowego — co stanowi znaczną przewagę nad bibliotekami wymagającymi oddzielnych ścieżek kodu dla każdego formatu.
Eksport do formatu CSV jest szczególnie przydatny, gdy odbiorcą końcowym jest skrypt Python pandas, narzędzie do zbiorczego importu danych z bazy danych lub platforma analityczna, która nie obsługuje plików XLSX w formacie binarnym.
W przypadku tabel zawierających dziesiątki tysięcy wierszy należy wziąć pod uwagę wydajność. Poniższy wzorzec zmniejsza obciążenie pamięci poprzez skonstruowanie pełnego zestawu danych w jednym przebiegu:
| Podejście | Obsługiwane wiersze | Wymagane biuro | Zachowanie typografii |
|---|---|---|---|
| Microsoft.Office.Interop.Excel | Do ~65 tys. znaków (powolne) | Tak | Częściowe |
| IronXL (komórki tekstowe) | Ponad 1 mln wierszy | Nie | Nie (cały tekst) |
| IronXL (komórki z typami danych) | Ponad 1 mln wierszy | Nie | Tak |
| IronXL z DataTable | Ponad 1 mln wierszy | Nie | Tak (automatycznie) |
Gdy DataGridView jest powiązany z DataTable, można bezpośrednio załadować tabelę do IronXL za pomocą metody WorkSheet.LoadDataTable, całkowicie pomijając iterację komórka po komórce. To podejście jest szybsze i automatycznie zachowuje wszystkie typy kolumn.
Dla siatek nie obsługiwanych przez DataTable, wzorzec komórka po komórce pokazany wcześniej pozostaje standardowym podejściem. Jeśli potrzebujesz eksportować asynchronicznie, aby utrzymać responsywność interfejsu użytkownika podczas dużych eksportów, otocz logikę eksportu wywołaniem Task.Run i await wynik na wątku tła. W dokumentacji dotyczącej asynchronicznych operacji na plikach można znaleźć wzorce dotyczące przesyłania wyników z powrotem do wątku interfejsu użytkownika.
Tradycyjne rozwiązania .NET używały Microsoft.Office.Interop.Excel do sterowania działającym procesem Excel. Takie podejście powoduje kilka problemów związanych z wdrażaniem i niezawodnością:
IronXL zapisuje dane bezpośrednio w formacie pliku OOXML bez uruchamiania żadnego zewnętrznego procesu. Aplikacje są wdrażane jako samodzielne jednostki. API biblioteki jest w pełni zarządzane przez .NET, więc zbieranie śmieci automatycznie zajmuje się pamięcią bez wywołania Marshal.ReleaseComObject. Szybkość jest znacznie wyższa, ponieważ nie dochodzi do komunikacji międzyprocesowej.
Dla zespołów rozważających alternatywne rozwiązania popularną opcją open source jest ClosedXML. IronXL oferuje szerszy zestaw funkcji w tym konwersję PDF, generowanie wykresów, oraz wsparcie komercyjne, co może być czynnikiem w decyzjach zakupu dla przedsiębiorstw. Zapoznaj się z opcjami licencyjnymi IronXL, aby dobrać odpowiedni poziom do wielkości zespołu i scenariusza wdrożenia.
| Funkcja | IronXL | Interop Office |
|---|---|---|
| Wymagana instalacja pakietu Office | Nie | Tak |
| Wdrożenie na serwerze / w chmurze | Tak | Nie (nieobsługiwane) |
| Model pamięci zarządzanej | Tak | Nie (wymagane czyszczenie COM) |
| Formaty XLSX / CSV / XLS | Wszystkie trzy | Zależy od zainstalowanego programu Excel |
| Eksport do formatu PDF z arkusza kalkulacyjnego | Tak | Wymagana dodatkowa biblioteka |
Sekcja samouczków IronXL obejmuje odczytywanie istniejących plików Excel, modyfikowanie szablonów, generowanie wykresów oraz stosowanie formatowania warunkowego — wszystkie te możliwości wynikają naturalnie z przedstawionego tutaj wzorca eksportu DataGridView.
Teraz masz działający kod C# do eksportowania DataGridView do sformatowanego pliku Excel przy użyciu IronXL. W tym miejscu należy wziąć pod uwagę następujące wskazówki:
try/catch i wyświetl przyjazny dla użytkownika komunikat, jeśli plik jest zablokowany lub ścieżka jest nieprawidłowaSaveFileDialog, aby umożliwić użytkownikom wybór lokalizacji wyjściowej i nazwy pliku w czasie wykonaniaDataTable na zapytanie do bazy danych używając ADO.NET lub Entity FrameworkWorkSheet w tym samym WorkBook, aby zorganizować powiązane zestawy danych
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
IronXL jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
API Excel, którego potrzebujesz, bez trudności z Office Interop.
