Créer des graphiques dans des documents Word à l'aide de C#

En tant que développeur C#, vous pouvez insérer par programme divers types de graphiques dans des documents Word. Il aide à présenter graphiquement vos données et informations. Dans cet article, vous apprendrez comment créer des graphiques dans des documents Word à l’aide de C#. Les sujets suivants sont abordés/couverts dans cet article:

• API C# pour insérer des graphiques dans des documents Word
• Créer des graphiques à colonnes dans des documents Word
• Créer des diagrammes de dispersion dans des documents Word à l’aide de C #
• Insérer des graphiques en aires dans des documents Word à l’aide de C #
• Insérer des graphiques à bulles dans des documents Word à l’aide de C #

API C# pour insérer des graphiques dans des documents Word

Pour insérer des graphiques dans des fichiers DOCX, nous utiliserons Aspose.Words pour .NET API. Il vous permet de générer, modifier, convertir, rendre et imprimer des fichiers sans utiliser Microsoft Word directement dans des applications multiplateformes. L’API vous permet d’insérer divers types de graphiques pris en charge dans des documents Word par programmation.

Vous pouvez soit télécharger la DLL de l’API, soit l’installer à l’aide de NuGet.

Install-Package Aspose.Words

Créer des graphiques à colonnes dans des documents Word

Vous pouvez créer des graphiques à colonnes dans des documents Word par programmation en suivant les étapes ci-dessous:

• Tout d’abord, créez un nouveau document en utilisant la classe Document.
• Maintenant, créez une instance de la classe DocumentBuilder avec l’objet de classe Document.
• Appelez ensuite la méthode DocumentBuilder.InsertChart(). Transmettez ChartType comme Column, avec height et width comme paramètres d’entrée.
• Obtenez des résultats dans l’objet de classe Shape.
• Maintenant, créez une instance de la classe Chart et affectez-lui l’objet Shape.Chart. Il permet d’accéder aux propriétés du graphique si cette forme a un graphique.
• Ensuite, obtenez la collection de séries de graphiques dans l’objet ChartSeriesCollection.
• Créer un tableau de noms de catégories.
• Maintenant, appelez la méthode ChartSeriesCollection.Add() pour ajouter des séries de graphiques. Passez le nom, le tableau de catégories et les valeurs en tant que paramètres d’entrée. Répétez cette étape pour ajouter d’autres séries.
• Enfin, appelez la méthode Document.Save() avec le chemin du fichier de sortie pour enregistrer le fichier.

L’exemple de code suivant montre comment créer un graphique à colonnes dans un document Word à l’aide de C#.

// Créer un document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Ajouter un graphique avec des données par défaut. Vous pouvez spécifier différents types et tailles de graphique.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// La propriété Chart de Shape contient toutes les options liées au graphique.
Chart chart = shape.Chart;

// Obtenez la collection de séries de graphiques.
ChartSeriesCollection seriesColl = chart.Series;
// Vérifiez le nombre de séries.
Console.WriteLine(seriesColl.Count);

// Supprimer la série générée par défaut.
seriesColl.Clear();

// Créez un tableau de noms de catégories, dans cet exemple, nous avons deux catégories.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Ajout de nouvelles séries. Veuillez noter que les tableaux de données ne doivent pas être vides et que les tableaux doivent avoir la même taille.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// Enregistrer le document
doc.Save(@"C:\Files\Words\ColumnsChart.docx");

Créer des diagrammes de dispersion dans des documents Word à l’aide de C#

Vous pouvez insérer des graphiques en nuage de points dans vos documents Word par programmation en suivant les étapes mentionnées précédemment. Cependant, vous devez définir ChartType.Scatter dans la méthode DocumentBuilder.InsertChart().

L’exemple de code suivant montre comment créer un graphique en nuage de points dans un document Word à l’aide de C#.

// Créer un nouveau document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insérer un graphique en nuage de points.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Utilisez cette surcharge pour ajouter des séries à tout type de graphiques en nuage de points.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Enregistrer le document
doc.Save(@"C:\Files\Words\ScatterChart.docx");

Insérer des graphiques en aires dans des documents Word à l’aide de C

Vous pouvez insérer des graphiques en aires dans des documents Word par programme en suivant les étapes mentionnées précédemment. Cependant, vous devez définir ChartType.Area dans la méthode DocumentBuilder.InsertChart(). L’exemple de code suivant montre comment créer un graphique en aires dans un document Word à l’aide de C#.

// Créer un nouveau document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insérer un graphique en aires.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Utilisez cette surcharge pour ajouter des séries à tout type de graphiques en aires, en radar et boursiers.
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// Enregistrer le document
doc.Save(@"C:\Files\Words\AreaChart.docx");

Insérer des graphiques à bulles dans des documents Word à l’aide de C#

Vous pouvez insérer des graphiques à bulles dans des documents Word par programmation en suivant les étapes mentionnées précédemment. Cependant, vous devez définir ChartType.Bubble dans la méthode DocumentBuilder.InsertChart(). L’exemple de code suivant montre comment créer un graphique à bulles dans un document Word à l’aide de C#.

// Créer un nouveau document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insérer un graphique à bulles.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Utilisez cette surcharge pour ajouter des séries à tout type de graphiques à bulles.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// Enregistrer le document
doc.Save(@"C:\Files\Words\BubbleChart.docx");

Obtenez une licence gratuite

Vous pouvez essayer l’API sans limitation d’évaluation en demandant une licence temporaire gratuite.

Conclusion

Dans cet article, vous avez appris comment créer des graphiques dans des documents Word à l’aide de C#. En particulier, vous avez appris à créer par programme des graphiques à colonnes, à aires, à bulles et à nuage de points dans des documents Word. De même, vous pouvez créer d’autres types de graphiques. Vous pouvez en savoir plus sur l’API Aspose.Words pour .NET en utilisant la documentation. En cas d’ambiguïté, n’hésitez pas à nous contacter sur le forum.

Voir également

• Travailler avec la table des matières dans le document Word C#