Les équipes financières demandent la même chose chaque trimestre : un fichier Excel propre avec les totaux, les ventilations régionales et une mise en forme qui résiste à un transfert au directeur financier. Lorsque vous devez générer des fichiers Excel avec .NET qui sont envoyés à de vrais utilisateurs, OpenXML brut donne l'impression d'écrire en assembleur. L'Open XML SDK de Microsoft fonctionne, mais il vous oblige à modéliser manuellement les parties, les relations et les chaînes partagées.

Xceed Workbooks pour .NET gère cette partie technique et expose une API de cellules et de styles que vous pouvez lire d'un coup d'œil. Ce didacticiel crée un rapport de ventes fonctionnel à partir d'une liste de transactions, applique la mise en forme des nombres et une mise en évidence conditionnelle en gras, écrit des cellules de formule et enregistre le résultat. Le même code s'exécute sur .NET Framework 4.6.1+, .NET 6, .NET 8 et .NET 9.

Avant d'écrire du code, installez le package de Xceed.Workbooks.NET sur NuGet. L'essai de 45 jours fonctionne sans clé de licence, vous pouvez donc exécuter l'exemple complet ci-dessous dès que le package est restauré.

Pourquoi Xceed Workbooks pour .NET pour les rapports de vente

Les rapports de vente comportent trois propriétés qui pénalisent les bibliothèques légères : des comptages de lignes variables, des types de données mixtes par colonne et des parties prenantes qui reformattent le fichier après sa livraison. Par conséquent, la bibliothèque que vous choisissez doit écrire de véritables objets Excel, pas du CSV avec une extension .xlsx.

Xceed Workbooks pour .NET écrit le format OOXML SpreadsheetML défini dans ECMA-376, ce qui signifie qu'Excel, LibreOffice, Google Sheets et Power BI ouvrent tous le fichier sans avertissement. Les cellules conservent leurs types natifs, les formules se recalculent à l'ouverture et les styles sont correctement conservés. Les alternatives dans ce domaine incluent EPPlus et ClosedXML ; les deux sont d'excellents choix, et la section vers la fin de cet article décrit quand chacun convient.

Ce que le rapport final contient

Le _sample_ produit une seule feuille de calcul nommée Ventes T4. Il contient une ligne d'en-tête figée, six colonnes de données (Date, Région, Commercial, Produit, Unités, Chiffre d'affaires), une ligne de totaux avec des formules SOMME, une cellule indiquant le chiffre d'affaires moyen, ainsi qu'un surlignage en gras sur les lignes où le chiffre d'affaires dépasse un seuil donné. Cela couvre environ 80% des demandes des utilisateurs professionnels avant qu'ils ne sollicitent des graphiques.

Configuration du projet et modèle de données

Créez un projet de console ciblant .NET 8 et ajoutez la référence du package. Les commandes CLI sont simples :

Ensuite, définissez l'enregistrement de transaction. Les enregistrements sont concis et immuables, ce qui correspond à la manière dont les pipelines de reporting traitent généralement les données :

Pour la démonstration, générez des transactions en mémoire. En production, cette liste provient d'EF Core, Dapper, ou d'un appel de service ; le code du rapport ci-dessous ne se soucie pas de l'origine des lignes.

XLSX C# : écriture de l'en-tête et des données

L'API Workbooks reflète la manière dont une personne décrit une feuille de calcul : ouvrir un classeur, récupérer une feuille de calcul, définir des valeurs de cellules par référence A1. Voici la première moitié du générateur de rapports, qui écrit le titre, les en-têtes de colonnes et les lignes de données :

Mise en forme, totaux et sortie stylisée

Les chiffres bruts sans mise en forme échouent au test du DAF. Le bloc suivant ajoute une ligne de totaux, une mise en forme monétaire sur la colonne des revenus, un format de date sur la colonne A et une mise en évidence en gras sur les lignes à revenus élevés. Ajoutez cette section avant l'appel workbook.Save() :

Exécution de l'échantillon

Câblez un petit Main qui construit des données de démonstration et appelle la fonction. Exécutez avec dotnet run et ouvrez SalesReport.xlsx :

Utiliser Xceed Workbooks pour .NET dans ASP.NET Core

La plupart des équipes souhaitent que ce rapport soit servi à partir d'un point de terminaison HTTP plutôt que d'une application console. Le schéma est identique, mais au lieu d'un chemin de fichier, écrivez le classeur dans un MemoryStream et retournez-le en tant que résultat de fichier. Reportez-vous à la documentation de gestion des fichiers ASP.NET Core pour obtenir des instructions sur le streaming de réponses.

When to choose which library

Choosing a spreadsheet library is a fit problem, not a ranking problem. Here is a neutral summary of the most common options:

Pick the library that matches your licensing model, your support expectations, and the breadth of Excel features you need. For Xceed customers already shipping DataGrid for WPF or Words for .NET, sharing a single vendor and license model often outweighs marginal feature differences.

Practical tips and pitfalls

A few habits keep production reports stable:

Ship the sales report this sprint

Questions fréquemment posées