Formater le nombre d'étiquettes de données dans un graphique

Introduction

La création de documents attrayants et informatifs implique souvent d’inclure des graphiques avec des étiquettes de données bien formatées. Si vous êtes un développeur .NET cherchant à améliorer vos documents Word avec des graphiques sophistiqués, Aspose.Words for .NET est une bibliothèque fantastique pour vous aider à y parvenir. Ce didacticiel vous guidera pas à pas tout au long du processus de formatage des étiquettes numériques dans un graphique à l’aide d’Aspose.Words for .NET.

Conditions préalables

Avant de vous plonger dans le code, vous devez mettre en place quelques prérequis :

Aspose.Words for .NET : assurez-vous que la bibliothèque Aspose.Words for .NET est installée. Si vous ne l’avez pas encore installé, vous pouvezTélécharger les ici.
Environnement de développement : vous devez disposer d’un environnement de développement .NET. Visual Studio est fortement recommandé.
Connaissance de base de C# : une connaissance de la programmation C# est essentielle car ce didacticiel implique l’écriture et la compréhension du code C#.
Licence temporaire : pour utiliser Aspose.Words sans aucune limitation, vous pouvez obtenir unepermis temporaire.

Passons maintenant au processus étape par étape de formatage des étiquettes numériques dans un graphique.

Importer des espaces de noms

Tout d’abord, nous devons importer les espaces de noms nécessaires pour travailler avec Aspose.Words for .NET. Ajoutez les lignes suivantes en haut de votre fichier C# :

using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Drawing.Charts;

Étape 1 : Configurez votre répertoire de documents

Avant de pouvoir commencer à manipuler votre document Word, vous devez spécifier le répertoire dans lequel votre document sera enregistré. Ceci est essentiel pour l’opération de sauvegarde ultérieure.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Remplacer"YOUR DOCUMENT DIRECTORY" avec le chemin réel vers votre répertoire de documents.

Étape 2 : initialiser le document et DocumentBuilder

L’étape suivante consiste à initialiser un nouveauDocument et unDocumentBuilder . LeDocumentBuilder est une classe d’assistance qui nous permet de construire le contenu du document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Étape 3 : Insérer un graphique dans le document

Maintenant, insérons un graphique dans le document en utilisant leDocumentBuilder. Dans ce didacticiel, nous utiliserons un graphique linéaire comme exemple.

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
chart.Title.Text = "Data Labels With Different Number Format";

Ici, nous insérons un graphique linéaire avec une largeur et une hauteur spécifiques et définissons le titre du graphique.

Étape 4 : Effacer la série par défaut et ajouter une nouvelle série

Par défaut, le graphique comportera des séries pré-générées. Nous devons les effacer et ajouter notre propre série avec des points de données spécifiques.

// Supprimez la série générée par défaut.
chart.Series.Clear();

// Ajoutez une nouvelle série avec des points de données personnalisés.
ChartSeries series1 = chart.Series.Add("Aspose Series 1", 
	new string[] { "Category 1", "Category 2", "Category 3" }, 
	new double[] { 2.5, 1.5, 3.5 });

Étape 5 : Activer les étiquettes de données

Pour afficher les étiquettes de données sur le graphique, nous devons les activer pour notre série.

series1.HasDataLabels = true;
series1.DataLabels.ShowValue = true;

Étape 6 : Formater les étiquettes de données

Le cœur de ce didacticiel est le formatage des étiquettes de données. Nous pouvons appliquer différents formats de nombres à chaque étiquette de données individuellement.

series1.DataLabels[0].NumberFormat.FormatCode = "\"$\"#,##0.00"; // Format monétaire
series1.DataLabels[1].NumberFormat.FormatCode = "dd/mm/yyyy"; // Format de date
series1.DataLabels[2].NumberFormat.FormatCode = "0.00%"; // Format pourcentage

De plus, vous pouvez lier le format d’une étiquette de données à une cellule source. Lorsqu’il est lié, leNumberFormat sera réinitialisé au général et hérité de la cellule source.

series1.DataLabels[2].NumberFormat.IsLinkedToSource = true;

Étape 7 : Enregistrez le document

Enfin, enregistrez le document dans le répertoire spécifié.

doc.Save(dataDir + "WorkingWithCharts.FormatNumberOfDataLabel.docx");

Cela enregistre votre document sous le nom spécifié et garantit que votre graphique avec les étiquettes de données formatées est préservé.

Conclusion

Le formatage des étiquettes de données dans un graphique à l’aide d’Aspose.Words pour .NET peut considérablement améliorer la lisibilité et le professionnalisme de vos documents Word. En suivant ce guide étape par étape, vous devriez maintenant pouvoir créer un graphique, ajouter des séries de données et formater les étiquettes de données pour répondre à vos besoins. Aspose.Words for .NET est un outil puissant qui permet une personnalisation et une automatisation approfondies des documents Word, ce qui en fait un atout inestimable pour les développeurs .NET.

FAQ

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

Aspose.Words for .NET est une bibliothèque puissante permettant de créer, manipuler et convertir des documents Word par programme à l’aide de C#.

Puis-je formater d’autres types de graphiques avec Aspose.Words pour .NET ?

Oui, Aspose.Words for .NET prend en charge une variété de types de graphiques, notamment à barres, à colonnes, à secteurs, etc.

Comment puis-je obtenir une licence temporaire pour Aspose.Words for .NET ?

Vous pouvez obtenir un permis temporaireici.

Est-il possible de lier des étiquettes de données aux cellules sources dans Excel ?

Oui, vous pouvez lier des étiquettes de données aux cellules source, permettant ainsi d’hériter du format numérique de la cellule source.

Où puis-je trouver une documentation plus détaillée pour Aspose.Words pour .NET ?

Vous pouvez trouver une documentation complèteici.