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

Caractéristiques d'IronXL

• Assistance humaine directe de notre équipe de développement .NET
• Installation rapide avec Microsoft Visual Studio
• GRATUIT pour le développement. Licences de $999

Comment créer et enregistrer rapidement un fichier Excel ?

Installez IronXL via NuGet ou téléchargez directement la DLL . La classe WorkBook est le point d'entrée pour toutes les opérations Excel, et la classe WorkSheet expose des méthodes pour manipuler des feuilles individuelles. Le guide complet pas à pas commence à l'étape 1 ci-dessous.

Comment ajouter une feuille de travail à mon classeur ?

Ajoutez des feuilles de calcul via CreateWorkSheet :

: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"

Un cahier d'exercices contient une ou plusieurs feuilles de travail. Chaque feuille de calcul est composée de lignes et de colonnes, avec des cellules à leurs intersections. Utilisez la méthode CreateWorkSheet pour ajouter de nouvelles feuilles à votre classeur.

• WorkBook.CreateWorkSheet(String) : Ajoute une nouvelle feuille avec le nom de l'onglet donné
• WorkSheet : Récupère une feuille existante par son nom
• Les noms des feuilles doivent être uniques au sein d'un classeur.

Comment puis-je définir manuellement les valeurs des cellules ?

L'accès aux cellules utilise les mêmes chaînes d'adresses de style A1 que vous voyez dans Excel :

: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

La propriété Value accepte divers types de données, y compris les chaînes, les nombres, les dates et les booléens. IronXL formate automatiquement les cellules en fonction du type de données.

Comment puis-je définir dynamiquement les valeurs des cellules ?

Lorsque le nombre de lignes est connu au moment de l'exécution, l'interpolation de chaîne facilite la lecture du corps de la boucle :

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

L'interpolation de chaîne ($"...") facilite la référence dynamique aux cellules. L'indexeur Item prend en charge à la fois les cellules individuelles et les plages.

Comment puis-je remplir un fichier Excel à partir d'une base de données ?

L'importation de données depuis des bases de données vers Excel est une exigence courante :

: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")

Cet exemple illustre la lecture de données Excel à partir de bases de données, l'application d'une mise en forme et l'utilisation de formules pour les calculs. La propriété NumberFormat permet la personnalisation du format de nombre comme dans Excel.

Comment puis-je définir les couleurs d'arrière-plan dans Excel ?

Les arrière-plans, les couleurs alternées des lignes et les dérogations de couleurs de police passent tous par l'objet Style sur une cellule ou une plage :

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

La méthode SetBackgroundColor accepte les codes couleur hexadécimaux. Associez les couleurs de fond avec Font.FontColor pour garder le contraste lisible sur des remplissages plus sombres.

Comment créer des bordures dans Excel ?

Les frontières permettent de définir les régions de données et d'améliorer leur structure :

: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 prend en charge différents types de bordures, notamment fines, moyennes, épaisses, doubles, pointillées et en pointillés. Chaque bord peut être stylisé indépendamment.

Comment configurer les propriétés d'une feuille de calcul ?

Protéger les feuilles de calcul et contrôler les options d'affichage :

: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

La protection des feuilles de calcul empêche les modifications accidentelles, tandis que le gel des volets permet de garder les lignes ou colonnes importantes visibles pendant le défilement.

Figure 7 - La ligne d'en-tête figée reste visible lors du défilement

Figure 8 - La protection par mot de passe empêche les modifications non autorisées

Comment configurer les paramètres de page et d'impression ?

Les options de mise en page d'impression (orientation, taille du papier, marges, mise à l'échelle, en-têtes, pieds de page) sont toutes exposées via WorkSheet.PrintSetup :

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

workBook.SaveAs("Budget.xlsx");

workBook.SaveAs("Budget.xlsx")

La classe IPrintSetup fournit des options de configuration d'impression complètes assorties aux paramètres d'impression d'Excel.

Figure 9 - Aperçu avant impression avec orientation paysage et marges personnalisées

Combien de temps prend réellement la génération ?

J'ai effectué un benchmark de génération sur une boîte Windows 11 (.NET 9.0.7) pour obtenir des chiffres concrets pour un classeur de la taille que la plupart des exportations en production atteignent. Le harnais construit un XLSX à 10 000 lignes et trois colonnes en mémoire et l'écrit sur le disque lors d'un seul appel SaveAs, à la fois à froid et à chaud. Le projet complet se trouve dans l'exemple CreateExcelBenchmark ci-dessous. Trois lancements de processus distincts ont abouti approximativement ici :

Le nombre à froid est dominé par le chargement de l'assemblage d'IronXL et le réchauffement du JIT. Une fois le processus chaud, la génération tombe dans la plage des 300 ms intermédiaires avec une certaine variance entre les exécutions due à l'activité d'arrière-plan. Pour des classeurs beaucoup plus volumineux (des centaines de milliers de lignes, plusieurs feuilles, forte stylisation), j'écris l'ensemble du classeur en mémoire et appelle SaveAs exactement une fois à la fin. La cause la plus courante des tickets "pourquoi mon export est-il si lent ?" que nous voyons est l'appel de SaveAs à plusieurs reprises à l'intérieur d'une boucle alors que le classeur est en croissance : chaque sauvegarde sérialise tout l'état actuel, donc le coût augmente à chaque itération.

Oubli de FormatString sur les dates et les monnaies

Le piège de formatage que je vois le plus : définir .Value à un DateTime mais oublier FormatString. La date est stockée correctement, mais Excel l'affiche comme un numéro de série brut (45292 signifie 2024-01-01) tant que vous n'avez pas appliqué une chaîne de format comme "yyyy-MM-dd". La monnaie a le même problème : le nombre est correct, mais sans "$#,##0.00" il s'affiche comme un simple décimal. Je note maintenant la valeur et le format sur des lignes adjacentes, de sorte que les deux ne peuvent pas diverger :

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 va tronquer silencieusement à 65 536 lignes

Celui-ci est mentionné dans la section de choix du format en haut de l'article, mais il mérite sa place ici parce que le mode d'échec est silencieux : ExcelFileFormat.XLS plafonne à 65 536 lignes par feuille, et les lignes au-delà de cette limite sont abandonnées sans exception ni avertissement. L'exportation "réussit" et vos données sont parties. Choisissez XLSX pour tout ce qui est lourd en données, sauf si un système en aval ne peut pas littéralement le lire.

"Excel dit que le fichier est corrompu"

Si un fichier généré refuse de s'ouvrir ou qu'Excel déclare qu'il est corrompu, la cause est presque toujours l'une des deux choses. Soit le flux de fichier n'a pas été correctement disposé, donc les octets sur disque sont tronqués ; ou vous avez écrit à un chemin qui était encore verrouillé par une exécution précédente, et seules certaines données sont passées. Assurez-vous que SaveAs (ou le flux qui l'entoure) est complètement terminé avant que quoi que ce soit d'autre ne touche le fichier, et préférez un bloc using autour de tout MemoryStream ou FileStream que vous emballez un classeur.

Projet d'exemple pour les chiffres de benchmark

Si vous voulez reproduire les chiffres de temps précédents, le banc d'essai est une petite application console .NET 9 :

: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

Exécutez-le sous dotnet run -c Release et échangez les comptes de lignes, de colonnes, ou de stylisation pour voir comment les chiffres évoluent avec la complexité du classeur.