Fusionner les cellules d'une plage nommée dans Excel

Introduction

Lorsque vous travaillez avec des fichiers Excel par programmation, l’une des tâches courantes que vous pouvez rencontrer est la fusion de cellules au sein d’une plage nommée. Que vous automatisiez la génération de rapports, créiez des tableaux de bord ou gériez simplement de grands ensembles de données, la fusion de cellules est une technique essentielle. Dans ce didacticiel, nous allons découvrir comment fusionner des cellules dans une plage nommée à l’aide d’Aspose.Cells pour .NET, une bibliothèque puissante qui permet aux développeurs de manipuler des fichiers Excel sans avoir besoin d’installer Microsoft Excel.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants à disposition :

Aspose.Cells pour .NET : vous pouvez le télécharger à partir duPage de publication d’Aspose.Cells.
.NET Framework installé sur votre machine.
Compréhension de base de C# : une familiarité avec des concepts tels que les classes, les méthodes et les objets sera utile.

Paquets d’importation

Avant de passer au codage, vous devez importer les espaces de noms nécessaires. Ces espaces de noms vous donneront accès aux fonctionnalités de la bibliothèque Aspose.Cells.

using System;
using System.IO;
using Aspose.Cells;

Une fois les prérequis et les packages posés, passons à la partie amusante : le codage !

Voici une description de la manière dont vous pouvez fusionner des cellules dans une plage nommée dans une feuille Excel à l’aide d’Aspose.Cells pour .NET.

Étape 1 : Créer un nouveau classeur

La première chose dont nous avons besoin est un classeur. Un classeur dans le langage Excel est l’équivalent d’un fichier Excel. Créons-en un.

// Instancier un nouveau classeur.
Workbook wb1 = new Workbook();

En initialisant un nouveau classeur, nous disposons désormais d’un fichier Excel vide prêt à être manipulé. C’est comme partir d’une toile vierge !

Étape 2 : Accéder à la première feuille de travail

Chaque classeur contient des feuilles de travail et, dans ce cas, nous souhaitons travailler avec la première. Allons la chercher !

// Prenez la première feuille de travail du classeur.
Worksheet worksheet1 = wb1.Worksheets[0];

Considérez la feuille de calcul comme les onglets individuels d’un fichier Excel où se trouvent les données réelles. Par défaut, nous accédons au tout premier onglet.

Étape 3 : Créer une plage de cellules

Maintenant que nous avons notre feuille de calcul, il est temps de créer une plage. Une plage fait référence à un bloc de cellules, qui peut s’étendre sur plusieurs lignes et colonnes.

// Créer une gamme.
Range mrange = worksheet1.Cells.CreateRange("D6", "I12");

Ici, nous sélectionnons les cellules de D6 à I12, un bloc qui couvre plusieurs lignes et colonnes. Nous allons bientôt fusionner cette plage !

Étape 4 : nommez la plage

Nommer une plage facilite la référence ultérieure, en particulier lorsqu’il s’agit de grands ensembles de données.

// Nommez la gamme.
mrange.Name = "TestRange";

En nommant cette plage « TestRange », nous pouvons la récupérer rapidement plus tard dans le code, sans avoir besoin de spécifier à nouveau les coordonnées de la cellule.

Étape 5 : fusionner la plage de cellules

Passons maintenant à la magie : fusionner les cellules de la plage que nous venons de créer !

// Fusionner les cellules de la plage.
mrange.Merge();

Cette étape fusionne toutes les cellules de D6 à I12 en une seule cellule. Parfait pour des éléments tels que des titres ou des résumés !

Étape 6 : Récupérer la plage nommée

Une fois les cellules fusionnées, nous souhaitons peut-être appliquer un formatage. Commençons par récupérer notre plage nommée.

// Obtenez la gamme.
Range range1 = wb1.Worksheets.GetRangeByName("TestRange");

La récupération de la plage par nom nous permet d’effectuer d’autres opérations, comme l’ajout de styles ou la saisie de données.

Étape 7 : Définir un style pour les cellules fusionnées

À quoi sert une cellule fusionnée si elle n’a pas l’air soignée ? Créons un objet de style pour aligner le texte et appliquer une couleur d’arrière-plan.

// Définir un objet de style.
Style style = wb1.CreateStyle();

// Définir l'alignement.
style.HorizontalAlignment = TextAlignmentType.Center;
style.VerticalAlignment = TextAlignmentType.Center;
style.Pattern = BackgroundType.Solid;
style.ForegroundColor = System.Drawing.Color.Aqua;

Ici, nous alignons le texte horizontalement et verticalement au centre, et définissons une couleur d’arrière-plan bleu clair (aqua). Élégant, non ?

Étape 8 : Appliquer le style à la plage

Après avoir défini le style, il est temps de l’appliquer à la plage fusionnée.

// Créez un objet StyleFlag.
StyleFlag flag = new StyleFlag();

// Activez l'attribut de style relatif.
flag.HorizontalAlignment = true;
flag.VerticalAlignment = true;
flag.CellShading = true;

// Appliquer le style à la plage.
range1.ApplyStyle(style, flag);

LeStyleFlagindique à Aspose.Cells quelles propriétés de style appliquer : alignement, ombrage, etc. Cela vous donne un contrôle précis sur la façon dont le style est appliqué.

Étape 9 : Saisir les données dans la plage fusionnée

Qu’est-ce qu’une plage formatée sans contenu ? Ajoutons du texte.

// Entrez les données dans la plage.
range1[0, 0].PutValue("Welcome to Aspose APIs.");

Cela place le texte « Bienvenue dans les API Aspose » dans la première cellule de notre plage fusionnée. La cellule étant fusionnée, ce texte s’étendra sur toutes les cellules de D6 à I12.

Étape 10 : Enregistrez le fichier Excel

Enfin, enregistrons le classeur sous forme de fichier Excel.

// Enregistrez le fichier Excel.
wb1.Save(dataDir + "outputMergeCellsInNamedRange.xlsx");

Ici, le classeur est enregistré avec le nom « outputMergeCellsInNamedRange.xlsx » dans votre répertoire spécifié.

Conclusion

Et voilà ! Vous avez réussi à fusionner des cellules dans une plage nommée, à appliquer une mise en forme soignée et même à saisir des données, le tout avec Aspose.Cells pour .NET. Que vous travailliez sur l’automatisation de rapports, la manipulation de fichiers Excel ou que vous appreniez simplement de nouvelles techniques, ce guide étape par étape devrait vous donner les bases dont vous avez besoin.

FAQ

Puis-je fusionner plusieurs plages non contiguës dans Aspose.Cells ?

Non, vous ne pouvez fusionner que des cellules contiguës dans Aspose.Cells.

Puis-je annuler une opération de fusion par programmation ?

Une fois les cellules fusionnées, vous pouvez les dissocier à l’aide de laUnMerge() méthode dans Aspose.Cells.

La fusion des cellules supprime-t-elle les données qu’elles contiennent ?

S’il y a des données dans les cellules avant la fusion, les données de la première cellule de la plage seront conservées.

Puis-je appliquer différents styles à des cellules individuelles dans une plage fusionnée ?

Non, une plage fusionnée agit comme une cellule unique, vous ne pouvez donc pas appliquer des styles différents aux cellules individuelles qu’elle contient.

Comment accéder à une cellule fusionnée après la fusion ?

Après la fusion, vous pouvez toujours accéder à la cellule fusionnée en utilisant les coordonnées de son coin supérieur gauche.

Identifier les cellules dans une plage nommée dans Excel