How to Create an Excel File in C# (.NET Tutorial)

IronXL Features

• Menschlicher Support direkt von unserem .NET-Entwicklungsteam
• Schnelle Installation mit Microsoft Visual Studio
• KOSTENLOS für die Entwicklung. Lizenzen von $999

Wie kann ich schnell eine Excel-Datei erstellen und speichern?

Installieren Sie IronXL über NuGet oder laden Sie die DLL direkt herunter. Die Klasse WorkBook ist der Einstiegspunkt für alle Excel-Operationen, und die Klasse WorkSheet stellt Methoden zur Verfügung, um einzelne Tabellenblätter zu manipulieren. Die vollständige Schritt-für-Schritt-Anleitung beginnt unten bei Schritt 1.

Wie füge ich ein Arbeitsblatt zu meiner Arbeitsmappe hinzu?

Fügen Sie Tabellenblätter über CreateWorkSheet hinzu:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-4.cs

workSheet["A1"].Value = "January";
workSheet["B1"].Value = "February";
workSheet["C1"].Value = "March";
workSheet["D1"].Value = "April";
workSheet["E1"].Value = "May";
workSheet["F1"].Value = "June";
workSheet["G1"].Value = "July";
workSheet["H1"].Value = "August";
workSheet["I1"].Value = "September";
workSheet["J1"].Value = "October";
workSheet["K1"].Value = "November";
workSheet["L1"].Value = "December";

workSheet("A1").Value = "January"
workSheet("B1").Value = "February"
workSheet("C1").Value = "March"
workSheet("D1").Value = "April"
workSheet("E1").Value = "May"
workSheet("F1").Value = "June"
workSheet("G1").Value = "July"
workSheet("H1").Value = "August"
workSheet("I1").Value = "September"
workSheet("J1").Value = "October"
workSheet("K1").Value = "November"
workSheet("L1").Value = "December"

Eine Arbeitsmappe enthält ein oder mehrere Arbeitsblätter. Jedes Arbeitsblatt besteht aus Zeilen und Spalten, mit Zellen an ihren Schnittstellen. Verwenden Sie die Methode CreateWorkSheet, um neue Tabellenblätter zu Ihrem Arbeitsbuch hinzuzufügen.

• WorkBook.CreateWorkSheet(String): Fügt ein neues Blatt mit dem angegebenen Tabnamen hinzu
• WorkSheet: Ruft ein bestehendes Blatt nach Name ab
• Die Tabellennamen müssen innerhalb einer Arbeitsmappe eindeutig sein.

Wie kann ich Zellenwerte manuell festlegen?

Der Zugriff auf Zellen erfolgt mit den gleichen Adressstrings im A1-Stil, die Sie in Excel sehen:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-5.cs

Random r = new Random();
for (int i = 2 ; i <= 11 ; i++)
{
    workSheet["A" + i].Value = r.Next(1, 1000);
    workSheet["B" + i].Value = r.Next(1000, 2000);
    workSheet["C" + i].Value = r.Next(2000, 3000);
    workSheet["D" + i].Value = r.Next(3000, 4000);
    workSheet["E" + i].Value = r.Next(4000, 5000);
    workSheet["F" + i].Value = r.Next(5000, 6000);
    workSheet["G" + i].Value = r.Next(6000, 7000);
    workSheet["H" + i].Value = r.Next(7000, 8000);
    workSheet["I" + i].Value = r.Next(8000, 9000);
    workSheet["J" + i].Value = r.Next(9000, 10000);
    workSheet["K" + i].Value = r.Next(10000, 11000);
    workSheet["L" + i].Value = r.Next(11000, 12000);
}

Dim r As New Random()
For i As Integer = 2 To 11
	workSheet("A" & i).Value = r.Next(1, 1000)
	workSheet("B" & i).Value = r.Next(1000, 2000)
	workSheet("C" & i).Value = r.Next(2000, 3000)
	workSheet("D" & i).Value = r.Next(3000, 4000)
	workSheet("E" & i).Value = r.Next(4000, 5000)
	workSheet("F" & i).Value = r.Next(5000, 6000)
	workSheet("G" & i).Value = r.Next(6000, 7000)
	workSheet("H" & i).Value = r.Next(7000, 8000)
	workSheet("I" & i).Value = r.Next(8000, 9000)
	workSheet("J" & i).Value = r.Next(9000, 10000)
	workSheet("K" & i).Value = r.Next(10000, 11000)
	workSheet("L" & i).Value = r.Next(11000, 12000)
Next i

Die Eigenschaft Value akzeptiert verschiedene Datentypen, einschließlich Zeichenketten, Zahlen, Daten und Booleans. IronXL formatiert Zellen automatisch basierend auf dem Datentyp.

Wie kann ich Zellenwerte dynamisch festlegen?

Wenn die Anzahl der Zeilen zur Laufzeit bekannt ist, macht die Zeichenfolgeninterpolation den Schleifenkörper leicht lesbar:

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

' Initialize random number generator for sample data
Dim r As New Random()

' Populate cells with random budget data for each month
For i As Integer = 2 To 11
	' Set different budget categories with increasing ranges
	workSheet($"A{i}").Value = r.Next(1, 1000) ' Office Supplies
	workSheet($"B{i}").Value = r.Next(1000, 2000) ' Utilities
	workSheet($"C{i}").Value = r.Next(2000, 3000) ' Rent
	workSheet($"D{i}").Value = r.Next(3000, 4000) ' Salaries
	workSheet($"E{i}").Value = r.Next(4000, 5000) ' Marketing
	workSheet($"F{i}").Value = r.Next(5000, 6000) ' IT Services
	workSheet($"G{i}").Value = r.Next(6000, 7000) ' Travel
	workSheet($"H{i}").Value = r.Next(7000, 8000) ' Training
	workSheet($"I{i}").Value = r.Next(8000, 9000) ' Insurance
	workSheet($"J{i}").Value = r.Next(9000, 10000) ' Equipment
	workSheet($"K{i}").Value = r.Next(10000, 11000) ' Research
	workSheet($"L{i}").Value = r.Next(11000, 12000) ' Misc
Next i

' Alternative: Set range of cells with same value
workSheet("A13:L13").Value = 0 ' Initialize totals row

String-Interpolation ($"...") macht es einfach, auf Zellen dynamisch zu verweisen. Der Indexer Item unterstützt sowohl einzelne Zellen als auch Bereiche.

Wie kann ich Daten aus einer Datenbank in eine Excel-Tabelle übertragen?

Das Laden von Daten aus Datenbanken in Excel ist eine häufige Anforderung:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-7.cs

workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

Dieses Beispiel zeigt das Lesen von Excel-Daten aus Datenbanken, das Anwenden von Formatierungen und die Verwendung von Formeln für Berechnungen. Die Eigenschaft NumberFormat ermöglicht benutzerdefiniertes Zahlenformatieren wie in Excel.

Wie kann ich in Excel Hintergrundfarben festlegen?

Hintergründe, abwechselnde Zeilenfarben und Schriftfarben-Überschreibungen erfolgen alle über das Objekt Style auf einer Zelle oder einem Bereich:

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

' Set header row background to light gray using hex color
workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

' Apply different colors for data categorization
workSheet("A2:A11").Style.SetBackgroundColor("#E7F3FF") ' Light blue for January
workSheet("B2:B11").Style.SetBackgroundColor("#FFF2CC") ' Light yellow for February

' Highlight important cells with bold colors
workSheet("L12").Style.SetBackgroundColor("#FF0000") ' Red for totals
workSheet("L12").Style.Font.FontColor = "#FFFFFF" ' White text

' Create alternating row colors for better readability
For row As Integer = 2 To 11
	If row Mod 2 = 0 Then
		workSheet($"A{row}:L{row}").Style.SetBackgroundColor("#F2F2F2")
	End If
Next row

Die Methode SetBackgroundColor akzeptiert Hex-Farbcode. Kombinieren Sie Hintergrundfarben mit Font.FontColor, um den Kontrast bei dunkleren Füllungen lesbar zu halten.

Wie erstelle ich Rahmen in Excel?

Rahmen helfen, Datenregionen zu definieren und die Struktur zu verbessern:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-9.cs

// Use IronXL built-in aggregations
decimal sum = workSheet["A2:A11"].Sum();
decimal avg = workSheet["B2:B11"].Avg();
decimal max = workSheet["C2:C11"].Max();
decimal min = workSheet["D2:D11"].Min();

// Assign value to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;

' Use IronXL built-in aggregations
Dim sum As Decimal = workSheet("A2:A11").Sum()
Dim avg As Decimal = workSheet("B2:B11").Avg()
Dim max As Decimal = workSheet("C2:C11").Max()
Dim min As Decimal = workSheet("D2:D11").Min()

' Assign value to cells
workSheet("A12").Value = sum
workSheet("B12").Value = avg
workSheet("C12").Value = max
workSheet("D12").Value = min

IronXL unterstützt verschiedene Rahmentypen, darunter Dünn, Mittel, Dick, Doppel, Gepunktet und Gestichelt. Jede Rahmenseite kann unabhängig voneinander gestylt werden.

Wie kann ich die Eigenschaften eines Arbeitsblatts konfigurieren?

Arbeitsblätter schützen und Anzeigeoptionen kontrollieren:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-11.cs

workSheet.SetPrintArea("A1:L12");
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape;
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4;

workSheet.SetPrintArea("A1:L12")
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4

Arbeitsblattschutz verhindert versehentliche Änderungen, während Einfriefen von Fenstern wichtige Zeilen oder Spalten beim Scrollen sichtbar hält.

Abbildung 7 - Gefrorene Kopfzeile bleibt beim Scrollen sichtbar

Abbildung 8 - Passwortschutz verhindert unbefugte Bearbeitungen

Wie konfiguriere ich die Seiten- und Druckeinstellungen?

Drucklayout-Optionen (Ausrichtung, Papiergröße, Ränder, Skalierung, Kopf- und Fußzeilen) werden alle über WorkSheet.PrintSetup bereitgestellt:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-12.cs

workBook.SaveAs("Budget.xlsx");

workBook.SaveAs("Budget.xlsx")

Die Klasse IPrintSetup bietet umfassende Druckkonfigurationsoptionen, die den Excel-Druckeinstellungen entsprechen.

Abbildung 9 - Druckvorschau mit Querformat und benutzerdefinierten Rändern

Wie lange dauert die Generierung tatsächlich?

Ich habe einen Generierungs-Benchmark auf einem Windows 11-Rechner (.NET 9.0.7) durchgeführt, um konkrete Zahlen für eine Arbeitsmappe zu erhalten, die etwa die Größe der meisten Produktexporte hat. Das Harness erstellt ein 10.000-Zeilen-, drei-Spalten-XLSX im Speicher und schreibt es in einer einzelnen SaveAs-Aufruf, sowohl kalt als auch warm, auf die Festplatte. Das vollständige Projekt befindet sich weiter unten im CreateExcelBenchmark Beispielprojekt. Drei separate Prozessstarts ergaben sich ungefähr hier:

Die kalte Zahl wird von IronXL's Assembly-Load- und JIT-Aufwärmen dominiert. Sobald der Prozess aufgewärmt ist, fällt die Generierung in den mittleren 300-ms-Bereich mit ein wenig Variabilität von Hintergrundaktivitäten. Für erheblich größere Arbeitsbücher (Hunderttausende von Zeilen, mehrere Blätter, umfangreiches Styling) schreibe ich das gesamte Arbeitsbuch im Speicher und rufe SaveAs exakt einmal am Ende auf. Der häufigste Grund für 'Warum ist mein Export so langsam?' Tickets, die wir sehen, ist das wiederholte Aufrufen von SaveAs innerhalb einer Schleife, während das Arbeitsbuch wächst: Jeder Speicherstand serialisiert den gesamten aktuellen Zustand, daher steigen die Kosten mit jeder Iteration.

Vergessen von FormatString bei Daten und Währungen

Die häufigste Formatierungsfalle, die ich sehe: Setzen .Value auf ein DateTime, aber Vergessen von FormatString. Das Datum wird korrekt gespeichert, aber Excel zeigt es als rohe Seriennummer an (45292 bedeutet 2024-01-01), bis Sie einen Formatstring wie "yyyy-MM-dd" anwenden. Währung hat das identische Problem: Die Zahl ist richtig, aber ohne "$#,##0.00" wird sie als nackte Dezimalzahl dargestellt. Ich schreibe den Wert und das Format jetzt in aufeinanderfolgenden Zeilen, so dass die beiden nicht auseinanderlaufen können:

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

Dim dateCell = sheet("A2")
dateCell.Value = DateTime.Today
dateCell.FormatString = "yyyy-MM-dd"

Dim moneyCell = sheet("B2")
moneyCell.Value = 1499.95D
moneyCell.FormatString = "$#,##0.00"

XLS trunkiert stillschweigend bei 65.536 Zeilen

Dies wird im Formatwahl-Abschnitt oben im Artikel erwähnt, aber es verdient seinen Platz hier, weil der Fehler stumm ist: ExcelFileFormat.XLS begrenzt auf 65.536 Zeilen pro Blatt, und Zeilen über dieses Limit hinaus werden ohne Ausnahme oder Warnung fallen gelassen. Der Export "erfolgt" und Ihre Daten sind weg. Wählen Sie für alles, was datenintensiv ist, XLSX, es sei denn, ein nachgeschaltetes System kann es buchstäblich nicht lesen.

"Excel sagt, die Datei sei beschädigt"

Wenn eine generierte Datei sich weigert zu öffnen oder Excel behauptet, sie sei beschädigt, liegt die Ursache fast immer an einem von zwei Dingen. Entweder wurde der Dateistream nicht korrekt geschlossen, so dass die Bytes auf der Festplatte abgeschnitten sind; oder Sie haben an einen Pfad geschrieben, der noch von einem vorherigen Lauf gesperrt war, und nur ein Teil der Daten ist angekommen. Stellen Sie sicher, dass SaveAs (oder der Stream, der ihn umgibt) vollständig abgeschlossen ist, bevor irgendetwas anderes die Datei berührt, und bevorzugen Sie einen using Block um jeden MemoryStream oder FileStream, den Sie in ein Arbeitsbuch einfügen.

Beispielprojekt für die Benchmark-Zahlen

Wenn Sie die Timing-Zahlen aus früher reproduzieren möchten, ist das Testprogramm eine kleine .NET 9 Konsolenanwendung:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-15.cs

// CreateExcelBenchmark/Program.cs (excerpt)
IronXL.License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY");

var sw = Stopwatch.StartNew();
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("Data");
sheet["A1"].Value = "Id";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Amount";
for (int i = 0; i < 10_000; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = i + 1;
    sheet[$"B{row}"].Value = $"Item {i + 1}";
    sheet[$"C{row}"].Value = (i + 1) * 1.25m;
}
workbook.SaveAs("Generated.xlsx");
sw.Stop();
Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms");

Imports System
Imports System.Diagnostics
Imports IronXL

Module Program
    Sub Main()
        License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY")

        Dim sw As Stopwatch = Stopwatch.StartNew()
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim sheet As WorkSheet = workbook.CreateWorkSheet("Data")
        sheet("A1").Value = "Id"
        sheet("B1").Value = "Name"
        sheet("C1").Value = "Amount"
        For i As Integer = 0 To 9999
            Dim row As Integer = i + 2
            sheet($"A{row}").Value = i + 1
            sheet($"B{row}").Value = $"Item {i + 1}"
            sheet($"C{row}").Value = (i + 1) * 1.25D
        Next
        workbook.SaveAs("Generated.xlsx")
        sw.Stop()
        Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms")
    End Sub
End Module

Führen Sie es unter dotnet run -c Release aus und tauschen Sie Ihre eigenen Zeilenanzahlen, Spaltenanzahlen oder Styling aus, um zu sehen, wie sich die Zahlen mit der Komplexität des Arbeitsbuchs ändern.