Comment créer un nouveau classeur Excel en C#

Comment puis-je commencer à créer des classeurs Excel en C# ?

Dans ce tutoriel, nous apprendrons à créer un nouveau classeur en utilisant IronXL en C#. Nous allons passer en revue les étapes nécessaires, de la configuration de votre environnement de développement à l'écriture du code qui génère un nouveau classeur Excel. Vous découvrirez comment créer des feuilles de calcul par programmation sans installer Excel sur votre ordinateur.

À la fin de ce tutoriel, vous comprendrez parfaitement comment utiliser IronXL pour créer des classeurs Excel par programmation, ce qui vous permettra d'intégrer facilement les fonctionnalités d'Excel dans vos applications C#. Commençons !

Qu'est-ce qu'IronXL ?

IronXL est une bibliothèque C# polyvalente qui vous permet de travailler avec des documents Excel sans avoir besoin de Microsoft Office Excel Interop ni d'aucune application Excel. Il vous permet de lire , de créer et de modifier facilement des classeurs, de formater des cellules, d'ajouter des formules et de travailler avec les formats de fichiers Excel modernes et anciens.

Vous pouvez valider des données, insérer des images, appliquer une mise en forme conditionnelle et créer des graphiques sans avoir besoin de Microsoft Office. Les développeurs peuvent facilement créer des solutions Excel pour des tâches telles que les rapports financiers, les tableaux de bord de données et la gestion des stocks grâce à IronXL. La bibliothèque prend en charge la conversion entre différents formats de feuilles de calcul, notamment XLSX, XLS, CSV, TSV, JSON et XML.

Commençons par créer un fichier Excel en C#.

Comment créer un nouveau projet C# pour le développement Excel ?

Ouvrez Visual Studio et créez un nouveau projet d'application Console C#. Appelez-le comme vous voulez. Vous pouvez également créer d'autres types de projets tels que ASP.NET MVC, Blazor, MAUI, Web Forms, Windows Forms, Web API, etc. Ce code est compatible avec tous les types de projets. J'utilise une application console par souci de simplicité et pour que le code soit applicable à tous les types de projets. La bibliothèque fonctionne même dans les conteneurs Docker et avec Azure Functions .

Comment installer le package NuGet IronXL ?

Pour installer le package IronXL dans votre projet C#, vous pouvez utiliser l'une des méthodes suivantes. Une configuration correcte des clés de licence garantit le bon fonctionnement de vos déploiements en production sans restrictions.

1. Pour installer IronXL, cliquez avec le bouton droit sur votre projet dans l'Explorateur de solutions, choisissez " Gérer les packages NuGet ", recherchez IronXL, puis procédez à l'installation.

! Fenêtre du Gestionnaire de packages NuGet affichant les résultats de la recherche du package IronXL.Excel, la version 2024.4.4 ayant été sélectionnée pour l'installation dans un projet C#

2. Vous pouvez également installer IronXL via la console du gestionnaire de paquets en utilisant la commande suivante :

Install-Package IronXL.Excel

Cette commande téléchargera, installera et ajoutera une référence d'assembly à votre projet. Attendez que le package soit téléchargé et installé. Une fois l'installation terminée, vous pouvez commencer à utiliser IronXL dans votre projet pour travailler avec des fichiers Excel par programmation.

! L'environnement de développement intégré Visual Studio affiche l'installation de la bibliothèque IronXL pour Excel via la console du gestionnaire de packages, avec un exemple de code C# pour la création de classeurs Excel.

Quels sont les problèmes d'installation les plus courants ? Les problèmes les plus courants concernent les conflits de packages NuGet ou le ciblage de versions .NET incompatibles. Assurez-vous que votre projet cible .NET Framework 4.6.2 ou supérieur, ou toute version de .NET Core/.NET 5+. Si vous rencontrez des problèmes, consultez le [guide de dépannage](https://ironsoftware.com/csharp/excel/troubleshooting/apply-a-license-key-in-ironxl/) ou vérifiez [la compatibilité de votre projet avec le framework cible](https://ironsoftware.com/csharp/excel/docs/) . ### Quand dois-je mettre à jour IronXL vers la dernière version ? Les mises à jour régulières apportent [des améliorations de performance](https://ironsoftware.com/csharp/excel/product-updates/milestones-performance/) et de nouvelles fonctionnalités. Consultez le [journal des modifications](https://ironsoftware.com/csharp/excel/product-updates/changelog/) trimestriellement pour prendre connaissance des mises à jour. Les mises à jour majeures incluent souvent des améliorations significatives, comme la récente [augmentation des performances de 40x](https://ironsoftware.com/csharp/excel/product-updates/milestones-enhancing/) . Toujours tester les mises à jour dans un environnement de développement avant de les déployer en production. ## Comment importer les espaces de noms nécessaires ? En haut de votre fichier C#, ajoutez l'espace de noms suivant : ```csharp using IronXL; ``` ### Pourquoi cet espace de noms est-il important ? L'espace de noms IronXL contient toutes les classes principales dont vous aurez besoin : `WorkBook` pour la gestion des fichiers Excel, `WorkSheet` pour les feuilles individuelles, et diverses classes de mise en forme et de style. Sans cette importation, vous devriez qualifier entièrement chaque type IronXL (comme `WorkBook` ), ce qui rendrait votre code verbeux et plus difficile à lire. ### De quels autres espaces de noms pourrais-je avoir besoin ? Selon vos besoins spécifiques, vous pourriez également avoir besoin : `using IronXL.Formatting` pour [la mise en forme avancée des cellules](https://ironsoftware.com/csharp/excel/how-to/cell-font-size/) , `using IronXL.Drawing` pour [travailler avec des images](https://ironsoftware.com/csharp/excel/how-to/add-extract-remove-worksheet-images/) ou `using IronXL.Styles` pour [des options de style](https://ironsoftware.com/csharp/excel/examples/excel-style-cells-borders-fonts/) complètes. La [documentation de référence de l'API](https://ironsoftware.com/csharp/excel/object-reference/api/) fournit une documentation complète sur les espaces de noms. ## Comment créer un nouveau fichier Excel par programmation ? À présent, écrivons le code permettant de créer un fichier Excel : ```csharp internal class Program { static void Main(string[] args) { // Create a new workbook in the XLSX format WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX); workBook.Metadata.Author = "Mr. Author"; // Set the author (optional) // Add a blank worksheet named "Sheet1" WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1"); // Add data to the new worksheet workSheet["A1"].Value = "Developer Name"; workSheet["A2"].Value = "John Grahm"; workSheet["A3"].Value = "David Smith"; workSheet["A4"].Value = "Rishi Kelkar"; // Save the Excel file as "Developers.xlsx" workBook.SaveAs("Developers.xlsx"); } } ``` Le code ci-dessus illustre comment créer un fichier Excel par programmation à l'aide d'IronXL en C#. Il commence par créer un nouveau classeur Excel (une nouvelle instance d'un fichier Excel) au format XLSX, définit les métadonnées de l'auteur à l'aide des [propriétés de métadonnées du classeur](https://ironsoftware.com/csharp/excel/how-to/edit-workbook-metadata/) , ajoute une feuille de calcul Excel vierge nommée " Sheet1 " à l'aide de la méthode `CreateWorkSheet()` , remplit les cellules A1 à A4 avec des données, et enregistre enfin le classeur sous le nom " Developers.xlsx ". IronXL offre une gamme de fonctionnalités pour travailler avec des fichiers Excel, notamment la création, la manipulation et l'enregistrement dans différents formats tels que XLSX, CSV, TSV, JSON, XML et HTML. Vous pouvez également [charger des feuilles de calcul existantes](https://ironsoftware.com/csharp/excel/how-to/load-spreadsheet/) pour les modifier ou [gérer plusieurs feuilles de calcul](https://ironsoftware.com/csharp/excel/how-to/manage-worksheet/) au sein d'un seul classeur. La sortie est comme suit : [Feuille de calcul Excel affichant une liste de noms de développeurs dans la colonne A, avec " Nom du développeur " en en-tête et trois noms : John Grahm, David Smith et Rishi Kelkar.](/static-assets/excel/blog/csharp-create-excel-new-workbook/csharp-create-excel-new-workbook-3.webp) ### Quelles sont les erreurs courantes lors de la création de classeurs ? Les erreurs courantes incluent les permissions d'accès aux fichiers, les chemins d'accès aux fichiers invalides ou les tentatives d'enregistrement dans un emplacement en lecture seule. Utilisez toujours des blocs try-catch autour des opérations sur les fichiers. Si vous rencontrez des erreurs " fichier en cours d'utilisation ", assurez-vous de ne pas ouvrir le fichier dans Excel pendant l'exécution de votre programme. Pour les environnements de production, il est conseillé de mettre en œuvre des mécanismes appropriés [de gestion des erreurs](https://ironsoftware.com/csharp/excel/troubleshooting/file-size-limits/) et de journalisation. ### Comment gérer les chemins d'accès aux fichiers et les autorisations ? Utilisez `Path.Combine()` pour assurer la compatibilité multiplateforme lors de la construction des chemins de fichiers. Pour les applications web, enregistrez les fichiers dans un dossier désigné disposant des autorisations d'écriture appropriées. Envisagez d'utiliser des répertoires temporaires pour la génération des fichiers avant de les déplacer vers leurs emplacements définitifs. Lorsque vous travaillez avec [des classeurs protégés](https://ironsoftware.com/csharp/excel/how-to/set-password-workbook/) , assurez-vous de disposer des identifiants nécessaires. ### Quand dois-je utiliser différents formats Excel ? Utilisez XLSX pour bénéficier des fonctionnalités modernes d'Excel et de fichiers plus petits. Choisissez XLS uniquement si la compatibilité avec Excel 2003 ou une version antérieure est requise. [Le format CSV](https://ironsoftware.com/csharp/excel/how-to/csharp-read-csv-file/) est idéal pour les échanges de données simples, sans mise en forme. Pour les applications web, envisagez [l'exportation au format HTML](https://ironsoftware.com/csharp/excel/examples/convert-excel-to-html/) pour l'affichage dans le navigateur. Le [guide de conversion](https://ironsoftware.com/csharp/excel/tutorials/csharp-open-write-excel-file/) explique les considérations spécifiques à chaque format. ## Comment appliquer une mise en forme et un style aux fichiers Excel ? IronXL vous permet de formater les cellules, d'appliquer des styles de police, de définir des couleurs d'arrière-plan et d'ajuster l'alignement. Vous pouvez créer des feuilles de calcul d'aspect professionnel en personnalisant l'apparence des cellules. La bibliothèque prend en charge [une mise en forme complète des cellules,](https://ironsoftware.com/csharp/excel/how-to/border-alignment/) incluant les bordures, les polices et les options d'alignement. ```csharp // Set style of heading for cell A1 workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background workSheet["A1"].Style.Font.Bold = true; // Bold font // Set border style for a specific range (A1:A4) var range = workSheet["A1:A4"]; range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border range.Style.RightBorder.Type = BorderType.Medium; // Medium right border range.Style.TopBorder.Type = BorderType.Medium; // Medium top border ``` Le code ci-dessus montre comment personnaliser l'apparence de cellules spécifiques dans une feuille de calcul Excel à l'aide d'IronXL en C#. Il commence par définir la [couleur et le motif de fond](https://ironsoftware.com/csharp/excel/how-to/background-pattern-color/) de la cellule A1 sur une teinte jaune clair et met la police en gras, la stylisant ainsi comme un titre. Ensuite, il définit une [plage s'étendant des cellules](https://ironsoftware.com/csharp/excel/how-to/select-range/) A1 à A4 et définit des bordures d'épaisseur moyenne le long des bords inférieur, gauche, droit et supérieur de cette plage, renforçant ainsi sa distinction visuelle dans la feuille de calcul. Ces options de style permettent aux développeurs de créer des documents Excel visuellement attrayants et organisés, adaptés à leurs besoins spécifiques. Vous pouvez également [définir les formats de données des cellules](https://ironsoftware.com/csharp/excel/how-to/set-cell-data-format/) pour les nombres, les dates et les devises. La sortie est comme suit : ! [Feuille de calcul Excel affichant une liste de noms de développeurs (John Grahm, David Smith, Rishi Kelkar) dans la colonne A avec surlignage jaune sur l'en-tête " Nom du développeur "](/static-assets/excel/blog/csharp-create-excel-new-workbook/csharp-create-excel-new-workbook-4.webp) ### Quelles sont les options de style disponibles ? IronXL offre de nombreuses possibilités de style : [personnalisation des polices](https://ironsoftware.com/csharp/excel/how-to/cell-font-size/) (taille, famille, couleur, gras, italique, souligné), arrière-plans de cellules avec motifs, options de bordure complètes, alignement du texte (horizontal et vertical), mise en forme des nombres et habillage du texte. Vous pouvez également [fusionner les cellules](https://ironsoftware.com/csharp/excel/how-to/csharp-excel-merge-cells/) pour les en-têtes et appliquer [un dimensionnement automatique aux lignes et aux colonnes](https://ironsoftware.com/csharp/excel/how-to/autosize-rows-columns/) pour un affichage optimal. ### Comment appliquer une mise en forme conditionnelle ? [La mise en forme conditionnelle](https://ironsoftware.com/csharp/excel/how-to/conditional-formatting/) dans IronXL vous permet de mettre en évidence les cellules en fonction de leurs valeurs. Vous pouvez créer des règles pour les échelles de couleurs, les barres de données et les jeux d'icônes. Cette fonctionnalité permet aux utilisateurs d'identifier rapidement les tendances, les valeurs aberrantes ou les points de données importants. L' [exemple de mise en forme conditionnelle](https://ironsoftware.com/csharp/excel/examples/excel-conditional-formatting/) illustre des implémentations pratiques. ### Pourquoi la mise en forme des cellules est-elle importante pour l'expérience utilisateur ? La mise en forme professionnelle transforme les données brutes en informations exploitables. Des feuilles de calcul bien formatées sont plus faciles à lire, réduisent les erreurs et témoignent de professionnalisme. Pensez à utiliser des schémas de couleurs cohérents, des en-têtes clairs et des formats numériques appropriés. Le [guide des formats numériques Excel](https://ironsoftware.com/csharp/excel/examples/excel-number-formats/) présente les meilleures pratiques en matière de présentation des données. ## Comment ajouter des formules et des calculs ? Vous pouvez ajouter des formules aux cellules par programmation. IronXL prend en charge un large éventail de [fonctions Excel](https://ironsoftware.com/csharp/excel/how-to/edit-formulas/) et [d'opérations mathématiques](https://ironsoftware.com/csharp/excel/how-to/math-functions/) . La bibliothèque permet à la fois de définir des formules et d'évaluer leurs résultats. ```csharp // Add a new column to display the length of developer names workSheet["B1"].Value = "Name Length"; workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading workSheet["B1"].Style.Font.Bold = true; // Bold font // Formula to calculate the length of names in column B workSheet["B2"].Value = "=LEN(A2)"; workSheet["B3"].Value = "=LEN(A3)"; workSheet["B4"].Value = "=LEN(A4)"; // Add a total count of the length of names in cell A5 workSheet["A5"].Value = "Sum of Length"; workSheet["B5"].Formula = "=SUM(B2:B4)"; ``` Le code ci-dessus illustre comment utiliser [les formules et les fonctions](https://ironsoftware.com/csharp/excel/examples/excel-formulas-csharp/) d'IronXL pour calculer la longueur des noms de développeurs et calculer la somme de ces longueurs dans une feuille de calcul Excel. Grâce à cette démonstration, les développeurs peuvent comprendre comment intégrer des formules et des fonctions dans IronXL pour effectuer des calculs et des manipulations dynamiques dans des feuilles de calcul Excel de manière programmatique, offrant ainsi flexibilité et automatisation dans les tâches de traitement des données. Tout d'abord, un en-tête intitulé " Longueur du nom " est ajouté à la cellule B1, avec un style mettant en évidence son importance. Ensuite, des formules sont appliquées aux cellules B2, B3 et B4 pour calculer la longueur du nom de chaque développeur à l'aide de la fonction LEN, en faisant référence à la cellule correspondante dans la colonne A. Cela permet le calcul automatique de la longueur des noms à mesure que les noms des développeurs changent. De plus, le nombre total de longueurs de noms est calculé dans la cellule B5 à l'aide de la [fonction SOMME](https://ironsoftware.com/csharp/excel/examples/aggregate-excel-functions/) , qui additionne les valeurs des cellules B2 à B4. Vous pouvez également utiliser d'autres [fonctions d'agrégation](https://ironsoftware.com/csharp/excel/how-to/math-functions/) telles que MOYENNE, MIN et MAX. En intégrant ces formules, la feuille de calcul est mise à jour dynamiquement. Bien que ce cas d'utilisation précis ne soit pas forcément pratique, il sert d'exemple d'utilisation des formules Excel dans le code. [Feuille de calcul Excel affichant les noms des développeurs dans la colonne A, la longueur de ces noms calculée dans la colonne B, et un total de 33 dans la cellule B5 avec la formule SOMME visible.](/static-assets/excel/blog/csharp-create-excel-new-workbook/csharp-create-excel-new-workbook-5.webp) ### Quelles fonctions Excel IronXL prend-il en charge ? IronXL prend en charge plus de 165 fonctions Excel, notamment les fonctions mathématiques (SOMME, MOYENNE, MIN, MAX), de manipulation de texte (NBCAR, CONCATENER, SUPPRIMER), logiques (SI, ET, OU), de recherche (RECHERCHEV, RECHERCHEH) et de date/heure. La [présentation des fonctionnalités](https://ironsoftware.com/csharp/excel/features/working-with-data/) fournit une liste exhaustive des fonctions prises en charge. ### Comment puis-je déboguer les erreurs de formule ? Lorsque des formules renvoient des erreurs, vérifiez : les références de cellules correctes, la syntaxe appropriée, les références circulaires et les incompatibilités de types de données. Utilisez la méthode `Evaluate()` pour tester les formules par programmation. Le [guide de dépannage](https://ironsoftware.com/csharp/excel/troubleshooting/excel-limitation-data-validation-for-string-lists/) aide à résoudre les problèmes de formule courants. ### Quand dois-je calculer les valeurs dans le code plutôt que dans les formules ? Utilisez les formules Excel lorsque : les utilisateurs ont besoin de voir les calculs dans Excel, les valeurs doivent se mettre à jour automatiquement ou vous créez des modèles. Utilisez C# pour vos calculs lorsque : vous gérez une logique métier complexe, vous avez besoin de meilleures performances pour les grands ensembles de données ou vous devez effectuer des calculs non pris en charge par Excel. Le [tutoriel sur les fonctions mathématiques](https://ironsoftware.com/csharp/excel/how-to/math-functions/) explique les deux approches. ## Quelles sont les prochaines étapes avec IronXL ? En résumé, ce tutoriel a démontré comment [créer](https://ironsoftware.com/csharp/excel/how-to/create-spreadsheet/) un nouveau classeur Excel en C# en utilisant [**IronXL**](/csharp/excel/) , une bibliothèque robuste facilitant la manipulation de fichiers Excel au sein de l'écosystème C#. Avec IronXL, les développeurs peuvent intégrer de manière transparente les fonctionnalités d'Excel dans leurs applications, de la configuration de l'environnement de développement à la génération programmatique de classeurs Excel. En plus de sa capacité à effectuer des tâches telles que la mise en forme, le style et l'application de formules, IronXL offre un [ensemble complet de fonctionnalités](https://ironsoftware.com/csharp/excel/features/) pour une gestion et une analyse efficaces des données. Pour obtenir des informations sur l'utilisation d'IronXL, consultez la page [de documentation](/csharp/excel/docs/) . IronXL propose également une collection d' [exemples de code](/csharp/excel/examples/read-excel/) utiles pour démarrer. Explorez des scénarios avancés tels que [la création de graphiques](https://ironsoftware.com/csharp/excel/how-to/csharp-create-excel-chart-programmatically/) , [l'utilisation de plages nommées](https://ironsoftware.com/csharp/excel/how-to/named-range/) ou [la protection des feuilles de calcul](https://ironsoftware.com/csharp/excel/how-to/set-password-worksheet/) . Les développeurs peuvent découvrir IronXL grâce à son [essai gratuit](trial-license) et à son achat, ce qui garantit une transition en douceur de l'évaluation à la mise en œuvre à grande échelle. Pour plus de détails sur les licences perpétuelles, consultez la page [des licences](licensing) . Pensez à explorer [les extensions de licence](https://ironsoftware.com/csharp/excel/licensing/extensions/) pour bénéficier de fonctionnalités supplémentaires. ### Où puis-je trouver des exemples plus avancés ? La [section des exemples](https://ironsoftware.com/csharp/excel/examples/create-excel-spreadsheet/) contient des tutoriels complets pour les scénarios avancés : [intégration de bases de données](https://ironsoftware.com/csharp/excel/examples/excel-sql-dataset/) , [création de tableaux croisés dynamiques](https://ironsoftware.com/csharp/excel/how-to/named-table/) , [automatisation Excel](https://ironsoftware.com/csharp/excel/examples/excel-update-database-records/) et [génération de rapports complexes](https://ironsoftware.com/csharp/excel/examples/export-excel-spreadsheet/) . Chaque exemple comprend un code complet et fonctionnel que vous pouvez adapter à vos projets. ### Comment obtenir de l'aide lorsque je suis bloqué ? IronXL propose plusieurs canaux d'assistance : [des guides de dépannage](https://ironsoftware.com/csharp/excel/troubleshooting/ironxl-security-cve/) complets, [une documentation API](https://ironsoftware.com/csharp/excel/object-reference/api/) détaillée, des forums communautaires et une assistance technique directe pour les utilisateurs sous licence. Commencez par consulter la documentation, examinez les exemples existants et n'hésitez pas à demander de l'aide si besoin. ### Quelles options de licence conviennent le mieux à mon projet ? IronXL propose [des options de licence](https://ironsoftware.com/csharp/excel/licensing/) flexibles : des licences de développement pour les développeurs individuels, des licences d'équipe pour les projets collaboratifs et des licences d'entreprise pour les déploiements à grande échelle. Chaque licence inclut un an d'assistance et de mises à jour. Envisagez [des options de mise à niveau](https://ironsoftware.com/csharp/excel/licensing/upgrades/) à mesure que votre projet se développe.