erstelle-diagramme-in-word-dokumenten-mit-csharp

Als C#-Entwickler können Sie verschiedene Arten von Diagrammen programmgesteuert in Word-Dokumente einfügen. Es hilft, Ihre Daten und Informationen grafisch darzustellen. In diesem Artikel erfahren Sie, wie Sie mit C# Diagramme in Word-Dokumenten erstellen.

Die folgenden Themen werden in diesem Artikel behandelt/behandelt:

C#-API zum Einfügen von Diagrammen in Word-Dokumente

Zum Einfügen von Diagrammen in DOCX-Dateien verwenden wir Aspose.Words for .NET API. Es ermöglicht Ihnen das Generieren, Ändern, Konvertieren, Rendern und Drucken von Dateien, ohne Microsoft Word direkt in plattformübergreifenden Anwendungen zu verwenden. Mit der API können Sie verschiedene unterstützte Diagrammtypen programmatisch in Word-Dokumente einfügen.

Sie können die DLL der API entweder herunterladen oder sie mit NuGet installieren.

Install-Package Aspose.Words

Erstellen Sie Säulendiagramme in Word-Dokumenten

Sie können Säulendiagramme in Word-Dokumenten programmgesteuert erstellen, indem Sie die folgenden Schritte ausführen:

  • Erstellen Sie zunächst ein neues Dokument mit der Klasse Document.
  • Erstellen Sie nun eine Instanz der Klasse DocumentBuilder mit dem Klassenobjekt Document.
  • Rufen Sie dann die Methode DocumentBuilder.InsertChart() auf. Übergeben Sie ChartType als Spalte mit Höhe und Breite als Eingabeparameter.
  • Rufen Sie Ergebnisse im Klassenobjekt Shape ab.
  • Erstellen Sie nun eine Instanz der Klasse Chart und weisen Sie ihr das Objekt Shape.Chart zu. Es bietet Zugriff auf die Diagrammeigenschaften, wenn dieses Shape über ein Diagramm verfügt.
  • Rufen Sie dann die Diagrammreihensammlung im Objekt ChartSeriesCollection ab.
  • Kategorienamen-Array erstellen.
  • Rufen Sie nun die Methode ChartSeriesCollection.Add() auf, um Diagrammreihen hinzuzufügen. Übergeben Sie Name, Kategorie-Array und Werte als Eingabeparameter. Wiederholen Sie diesen Schritt, um weitere Serien hinzuzufügen.
  • Rufen Sie schließlich die Methode Document.Save() mit dem Ausgabedateipfad auf, um die Datei zu speichern.

Das folgende Codebeispiel zeigt, wie Sie mit C# ein Säulendiagramm in einem Word-Dokument erstellen.

// Erstellen Sie ein Dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Diagramm mit Standarddaten hinzufügen. Sie können verschiedene Diagrammtypen und -größen angeben.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// Die Diagrammeigenschaft von Shape enthält alle diagrammbezogenen Optionen.
Chart chart = shape.Chart;

// Holen Sie sich die Sammlung von Diagrammreihen.
ChartSeriesCollection seriesColl = chart.Series;
// Überprüfen Sie die Anzahl der Serien.
Console.WriteLine(seriesColl.Count);

// Standardmäßig generierte Serien löschen.
seriesColl.Clear();

// Kategorienamen-Array erstellen, in diesem Beispiel haben wir zwei Kategorien.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Hinzufügen neuer Serien. Bitte beachten Sie, dass Daten-Arrays nicht leer sein dürfen und Arrays dieselbe Größe haben müssen.
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 });

// Speichern Sie das Dokument
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
Erstellen Sie Säulendiagramme in Word-Dokumenten mit C#.

Erstellen Sie Säulendiagramme in Word-Dokumenten mit C#

Erstellen Sie Punktdiagramme in Word-Dokumenten mit C#

Sie können Streudiagramme programmgesteuert in Ihre Word-Dokumente einfügen, indem Sie die zuvor erwähnten Schritte ausführen. Allerdings müssen Sie ChartType.Scatter in der Methode DocumentBuilder.InsertChart() festlegen.

Das folgende Codebeispiel zeigt, wie Sie mit C# ein Streudiagramm in einem Word-Dokument erstellen.

// Erstellen Sie ein neues Dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Punktdiagramm einfügen.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Verwenden Sie diese Überladung, um Reihen zu beliebigen Arten von Streudiagrammen hinzuzufügen.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Speichern Sie das Dokument
doc.Save(@"C:\Files\Words\ScatterChart.docx");
Erstellen Sie Punktdiagramme in Word-Dokumenten mit C#.

Erstellen Sie Punktdiagramme in Word-Dokumenten mit C#

Einfügen von Flächendiagrammen in Word-Dokumente mit C#

Sie können Flächendiagramme programmgesteuert in Word-Dokumente einfügen, indem Sie die zuvor erwähnten Schritte ausführen. Sie müssen jedoch ChartType.Area in der Methode DocumentBuilder.InsertChart() festlegen.

Das folgende Codebeispiel zeigt, wie Sie mit C# ein Flächendiagramm in einem Word-Dokument erstellen.

// Erstellen Sie ein neues Dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Flächendiagramm einfügen.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Verwenden Sie diese Überladung, um Serien zu jeder Art von Flächen-, Radar- und Aktiendiagrammen hinzuzufügen.
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 });

// Speichern Sie das Dokument
doc.Save(@"C:\Files\Words\AreaChart.docx");
Einfügen von Flächendiagrammen in Word-Dokumente mit C#.

Einfügen von Flächendiagrammen in Word-Dokumente mit C#

Blasendiagramme in Word-Dokumente mit C# einfügen

Sie können Blasendiagramme programmgesteuert in Word-Dokumente einfügen, indem Sie die zuvor erwähnten Schritte ausführen. Sie müssen jedoch ChartType.Bubble in der Methode DocumentBuilder.InsertChart() festlegen.

Das folgende Codebeispiel zeigt, wie Sie mit C# ein Blasendiagramm in einem Word-Dokument erstellen.

// Erstellen Sie ein neues Dokument
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Blasendiagramm einfügen.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Verwenden Sie diese Überladung, um Reihen zu jeder Art von Blasendiagrammen hinzuzufügen.
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 });

// Speichern Sie das Dokument
doc.Save(@"C:\Files\Words\BubbleChart.docx");
Blasendiagramme mit C# in Word-Dokumente einfügen.

Blasendiagramme in Word-Dokumente mit C# einfügen

Holen Sie sich eine kostenlose Lizenz

Sie können die API ohne Evaluierungseinschränkungen testen, indem Sie eine kostenlose temporäre Lizenz anfordern.

Fazit

In diesem Artikel haben Sie gelernt, wie Sie mit C# Diagramme in Word-Dokumenten erstellen. Insbesondere haben Sie gelernt, wie Sie Säulen-, Flächen-, Blasen- und Punktdiagramme in Word-Dokumenten programmgesteuert erstellen. Ebenso können Sie andere Arten von Diagrammen erstellen. Weitere Informationen zu Aspose.Words for .NET API finden Sie in der Dokumentation. Bei Unklarheiten können Sie uns gerne im Forum kontaktieren.

Siehe auch