maak-grafieken-in-word-documenten-met-csharp

Als C#-ontwikkelaar kunt u programmatisch verschillende soorten grafieken in Word-documenten invoegen. Het helpt om uw gegevens en informatie grafisch weer te geven. In dit artikel leert u hoe u grafieken maakt in Word-documenten met C#. In dit artikel worden de volgende onderwerpen besproken/behandeld:

  • [C# API om grafieken in Word-documenten in te voegen][2]
  • [Maak kolommengrafieken in Word-documenten][3]
  • [Maak spreidingsdiagrammen in Word-documenten met C#][4]
  • [Voeg vlakdiagrammen in Word-documenten in met C#][5]
  • [Bubbeldiagrammen invoegen in Word-documenten met C#][6]

C# API om grafieken in Word-documenten in te voegen

Voor het invoegen van grafieken in DOCX-bestanden gebruiken we [Aspose.Words for .NET API][7]. Hiermee kunt u bestanden genereren, wijzigen, converteren, renderen en afdrukken zonder gebruik te maken van Microsoft Word, rechtstreeks in platformonafhankelijke toepassingen. Met de API kunt u verschillende [ondersteunde grafiektypen][8] programmatisch invoegen in Word-documenten. U kunt de DLL van de API [downloaden][9] of installeren met [NuGet][10].

Install-Package Aspose.Words

Maak kolommendiagrammen in Word-documenten

U kunt kolomdiagrammen in Word-documenten programmatisch maken door de onderstaande stappen te volgen:

  • Maak eerst een nieuw document met de klasse [Document][11].
  • Maak nu een instantie van de klasse [DocumentBuilder][12] met het klasseobject Document.
  • Roep vervolgens de methode [DocumentBuilder.InsertChart()][13] aan. Geef [ChartType][8] door als Column, met height en width als invoerparameters.
  • Krijg resultaten in het klasseobject [Shape][14].
  • Maak nu een instantie van de klasse [Chart][15] en wijs er een object [Shape.Chart][16] aan toe. Het biedt toegang tot de diagrameigenschappen als deze vorm een diagram heeft.
  • Haal vervolgens de verzameling diagramreeksen op in het object [ChartSeriesCollection][17].
  • Maak een array met categorienamen.
  • Roep nu de methode [ChartSeriesCollection.Add()][18] aan om diagramreeksen toe te voegen. Geef naam, categoriearray en waarden door als invoerparameters. Herhaal deze stap om meer series toe te voegen.
  • Roep ten slotte de methode [Document.Save()][19] aan met het uitvoerbestandspad om het bestand op te slaan. Het volgende codevoorbeeld laat zien hoe je met C# een kolommendiagram maakt in een Word-document**.
    // Create a document
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    // Add chart with default data. You can specify different chart types and sizes.
    Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
    // Chart property of Shape contains all chart related options.
    Chart chart = shape.Chart;
    // Get chart series collection.
    ChartSeriesCollection seriesColl = chart.Series;
    // Check series count.
    Console.WriteLine(seriesColl.Count);
    // Delete default generated series.
    seriesColl.Clear();
    // Create category names array, in this example we have two categories.
    string[] categories = new string[] { "AW Category 1", "AW Category 2" };
    // Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
    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 });
    // Save the document
    doc.Save(@"C:\Files\Words\ColumnsChart.docx");
    view raw CreateChartsInWord_CSharp_InsertColumnsChart.cs hosted with ❤ by GitHub
    Maak kolommendiagrammen in Word-documenten met behulp van C#.

    Maak kolommendiagrammen in Word-documenten met behulp van C#

Maak spreidingsdiagrammen in Word-documenten met C#

U kunt spreidingsdiagrammen programmatisch in uw Word-documenten invoegen door de eerder genoemde stappen te volgen. U moet echter ChartType.Scatter instellen met de methode [DocumentBuilder.InsertChart()][21]. Het volgende codevoorbeeld laat zien hoe u een spreidingsdiagram maakt in een Word-document met behulp van C#.

// Create a new document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Scatter chart.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Scatter charts.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
// Save the document
doc.Save(@"C:\Files\Words\ScatterChart.docx");
view raw CreateChartsInWord_CSharp_InsertScatterChart.cs hosted with ❤ by GitHub
Maak spreidingsdiagrammen in Word-documenten met behulp van C#.

Maak spreidingsdiagrammen in Word-documenten met C#

Voeg vlakdiagrammen in Word-documenten in met C#

U kunt vlakdiagrammen programmatisch in Word-documenten invoegen door de eerder genoemde stappen te volgen. U moet echter ChartType.Area instellen met de methode [DocumentBuilder.InsertChart()][21]. Het volgende codevoorbeeld laat zien hoe u een vlakdiagram maakt in een Word-document met behulp van C#.

// Create a new document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Area chart.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Area, Radar and Stock charts.
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 });
// Save the document
doc.Save(@"C:\Files\Words\AreaChart.docx");
view raw CreateChartsInWord_CSharp_InsertAreaChart.cs hosted with ❤ by GitHub
Voeg vlakdiagrammen in Word-documenten in met behulp van C#.

Voeg vlakdiagrammen in Word-documenten in met C#

Ballondiagrammen in Word-documenten invoegen met C#

U kunt bellendiagrammen programmatisch in Word-documenten invoegen door de eerder genoemde stappen te volgen. U moet echter ChartType.Bubble instellen met de methode [DocumentBuilder.InsertChart()][21]. Het volgende codevoorbeeld laat zien hoe u een bellendiagram maakt in een Word-document met behulp van C#.

// Create a new document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Bubble chart.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Bubble charts.
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 });
// Save the document
doc.Save(@"C:\Files\Words\BubbleChart.docx");
view raw CreateChartsInWord_CSharp_InsertBubbleChart.cs hosted with ❤ by GitHub
Ballondiagrammen invoegen in Word-documenten met behulp van C#.

Ballondiagrammen in Word-documenten invoegen met C#

Ontvang een gratis licentie

U kunt de API uitproberen zonder evaluatiebeperkingen door [een gratis tijdelijke licentie][25] aan te vragen.

Conclusie

In dit artikel heb je geleerd hoe je grafieken maakt in Word-documenten met C#. U hebt met name geleerd hoe u kolom-, vlak-, bellen- en spreidingsdiagrammen programmatisch kunt maken in Word-documenten. Op dezelfde manier kunt u andere soorten grafieken maken. U kunt meer leren over Aspose.Words voor .NET API met behulp van de [documentatie][26]. Neem bij onduidelijkheden gerust contact met ons op via het [forum][27].

Zie ook