Définir les lignes du graphique

Introduction

Créer des graphiques visuellement attrayants et informatifs est essentiel dans la représentation des données. Que vous soyez un analyste de données, un chef d’entreprise ou simplement quelqu’un qui aime organiser les données, les graphiques peuvent considérablement améliorer la façon dont vous présentez vos informations. Ce didacticiel vous guidera tout au long du processus de définition des lignes de graphique à l’aide d’Aspose.Cells pour .NET, une bibliothèque puissante pour la manipulation de fichiers Excel. À la fin, vous saurez comment créer de superbes graphiques remplis de personnalisations pour faire ressortir vos données Excel !

Prérequis

Avant de plonger dans la partie codage, assurez-vous d’être équipé des éléments suivants :

  • Visual Studio : assurez-vous que Visual Studio est installé. Il est fortement recommandé d’utiliser la dernière version pour exploiter toutes les fonctionnalités.
  • .NET Framework : Votre projet doit être basé sur .NET Framework (ou .NET Core) où vous implémenterez Aspose.Cells.
  • Aspose.Cells pour .NET : téléchargez et installez Aspose.Cells à partir duSite Web d’Aspose.
  • Compréhension de base de C# : la familiarité avec le langage de programmation C# sera utile lors du codage.

Paquets d’importation

Pour commencer à utiliser Aspose.Cells, vous devez importer les espaces de noms nécessaires dans votre projet. Cela vous permettra d’accéder à toutes les fonctionnalités intéressantes qu’offre Aspose.Cells. Voici comment importer des packages dans votre fichier C# :

using Aspose.Cells;
using Aspose.Cells.Charts;
using System.Drawing;

Décomposons le processus en étapes faciles à gérer afin que vous puissiez le suivre facilement.

Étape 1 : définissez votre répertoire de sortie

Tout d’abord, vous aurez besoin d’un emplacement pour enregistrer votre fichier Excel nouvellement créé. Définissez le répertoire de sortie en haut de votre code comme ceci :

// Répertoire de sortie
string outputDir = "Your Output Directory";

Explication : remplacez « Votre répertoire de sortie » par le chemin où vous souhaitez qu’Aspose.Cells enregistre le fichier, par exempleC:\\MyExcelFiles\\.

Étape 2 : instancier un objet classeur

Nous allons maintenant créer un objet classeur, qui sert de conteneur pour votre feuille de calcul.

//Instanciation d'un objet Workbook
Workbook workbook = new Workbook();

Explication : Cette ligne crée une instance deWorkbookclasse de la bibliothèque Aspose.Cells. C’est comme ouvrir un nouveau fichier Excel vierge dans lequel vous pouvez commencer à ajouter vos feuilles et vos données.

Étape 3 : référencer une feuille de travail

Ensuite, vous devrez travailler avec une feuille spécifique de votre classeur. Nous allons prendre la première feuille de calcul.

// Obtention de la référence de la feuille de calcul nouvellement ajoutée en passant son index de feuille
Worksheet worksheet = workbook.Worksheets[0];

Explication : Les feuilles de calcul sont indexées à partir de 0, doncworksheets[0] fait référence à la première feuille de travail.

Étape 4 : ajouter des exemples de valeurs aux cellules

Remplissons quelques cellules avec des données que nous utiliserons plus tard pour créer notre graphique.

// Ajout de valeurs d'échantillon aux cellules
worksheet.Cells["A1"].PutValue(50);
worksheet.Cells["A2"].PutValue(100);
worksheet.Cells["A3"].PutValue(150);
worksheet.Cells["B1"].PutValue(60);
worksheet.Cells["B2"].PutValue(32);
worksheet.Cells["B3"].PutValue(50);

Explication : Ici, nous remplissons les cellules « A1 » à « A3 » et « B1 » à « B3 » avec des valeurs numériques. Celles-ci seront représentées dans notre graphique plus tard.

Étape 5 : Ajouter un graphique à la feuille de calcul

Il est maintenant temps de créer un graphique ! Nous allons ajouter un type de graphique à colonnes.

// Ajout d'un graphique à la feuille de calcul
int chartIndex = worksheet.Charts.Add(Aspose.Cells.Charts.ChartType.Column, 5, 0, 25, 10);

Explication : Cette ligne ajoute un graphique à colonnes à des coordonnées spécifiques sur la feuille de calcul. Les paramètres définissent l’emplacement où le graphique sera dessiné sur la grille.

Étape 6 : Accéder au graphique nouvellement ajouté

Vous devez maintenant référencer le graphique que vous venez de créer.

// Accéder à l'instance du graphique nouvellement ajouté
Aspose.Cells.Charts.Chart chart = worksheet.Charts[chartIndex];

Explication : Cela vous donne le contrôle sur l’instance du graphique, vous permettant de la personnaliser et de la styliser davantage.

Étape 7 : Ajouter une série de données au graphique

Ajoutons la série de données pour notre graphique.

// Ajout de SeriesCollection (source de données du graphique) au graphique allant de la cellule « A1 » à « B3 »
chart.NSeries.Add("A1:B3", true);

Explication : Cette ligne indique au graphique d’extraire les données de la plage spécifiée. Le deuxième paramètre spécifie si les plages de données incluent des catégories.

Étape 8 : Personnaliser l’apparence du graphique

Passons maintenant à la partie amusante : personnaliser votre graphique ! Modifions quelques couleurs.

// Définition de la couleur de premier plan de la zone de tracé
chart.PlotArea.Area.ForegroundColor = Color.Blue;

// Définition de la couleur de premier plan de la zone de graphique
chart.ChartArea.Area.ForegroundColor = Color.Yellow;

// Définition de la couleur de premier plan de la zone 1st SeriesCollection
chart.NSeries[0].Area.ForegroundColor = Color.Red;

// Définition de la couleur de premier plan de la zone du 1er point SeriesCollection
chart.NSeries[0].Points[0].Area.ForegroundColor = Color.Cyan;

// Remplissage de la zone de la 2e série Collection avec un dégradé
chart.NSeries[1].Area.FillFormat.SetOneColorGradient(Color.Lime, 1, Aspose.Cells.Drawing.GradientStyleType.Horizontal, 1);

Explication : Ici, vous personnalisez les couleurs des différents composants du graphique pour le rendre visuellement attrayant. Chaque ligne cible différentes zones du graphique.

Étape 9 : Appliquer les styles de ligne

Ensuite, vous pouvez modifier les styles de ligne de votre série de données pour rendre votre graphique non seulement joli, mais également professionnel.

// Application d'un style de ligne pointillée sur les lignes d'une SeriesCollection
chart.NSeries[0].Border.Style = Aspose.Cells.Drawing.LineType.Dot;

// Application d'un style de marqueur triangulaire sur les marqueurs de données d'une SeriesCollection
chart.NSeries[0].Marker.MarkerStyle = Aspose.Cells.Charts.ChartMarkerType.Triangle;

// Définir le poids de toutes les lignes d'une SeriesCollection sur moyen
chart.NSeries[1].Border.Weight = Aspose.Cells.Drawing.WeightType.MediumLine;

Explication : Le code ci-dessus personnalise les bordures de la série du graphique, en lui donnant une ligne en pointillés et même en changeant les marqueurs de points de données en triangles. Tout est une question de touche personnelle !

Étape 10 : Enregistrez votre classeur

Maintenant, sauvegardons votre travail acharné dans un fichier Excel.

// Sauvegarde du fichier Excel
workbook.Save(outputDir + "outputSettingChartLines.xlsx");

Explication : Cette ligne enregistre votre classeur avec le nom spécifié dans le répertoire de sortie que vous avez défini. Vous pouvez maintenant l’ouvrir et voir votre superbe graphique !

Étape 11 : Confirmation d’exécution

Enfin, confirmons que tout s’est bien passé.

Console.WriteLine("SettingChartLines executed successfully.");

Explication : Un message simple pour informer que votre code a été exécuté sans aucun problème.

Conclusion

Félicitations ! Vous maîtrisez désormais les bases de la création et de la personnalisation de graphiques à l’aide d’Aspose.Cells pour .NET. En quelques étapes simples, vous pouvez améliorer la présentation de vos données, la rendre plus compréhensible et visuellement attrayante. Lorsque vous expérimentez d’autres options de personnalisation, n’oubliez pas qu’un bon graphique raconte non seulement une histoire, mais captive également votre public.

FAQ

Qu’est-ce qu’Aspose.Cells pour .NET ?

Aspose.Cells pour .NET est une bibliothèque puissante pour manipuler des feuilles de calcul Excel dans des applications .NET.

Puis-je utiliser Aspose.Cells gratuitement ?

Oui, Aspose propose un essai gratuit pour tester ses fonctionnalités. Vous pouvez le téléchargerici.

Existe-t-il un support disponible pour Aspose.Cells ?

Absolument ! Vous pouvez obtenir de l’aide via leForum Aspose.

Puis-je créer d’autres types de graphiques à l’aide d’Aspose.Cells ?

Oui, Aspose prend en charge différents types de graphiques, notamment les graphiques linéaires, à secteurs et à aires.

Comment obtenir une licence temporaire pour Aspose.Cells ?

Vous pouvez postuler pour unpermis temporaire via le site Aspose.