Wie man Diagramme in Präsentationen in .NET erstellt

Eine neue Aspose.Slides for .NET API wurde veröffentlicht und unterstützt jetzt die Möglichkeit, PowerPoint‑Dokumente von Grund auf zu erstellen und vorhandene zu bearbeiten.

Support for Legacy Code

Um den mit früheren Aspose.Slides für .NET‑Versionen (vor 13.x) entwickelten Legacy‑Code zu verwenden, müssen Sie einige kleine Änderungen an Ihrem Code vornehmen, und der Code wird wie zuvor funktionieren. Alle Klassen, die in den alten Aspose.Slides für .NET unter den Namespaces Aspose.Slide und Aspose.Slides.Pptx vorhanden waren, sind jetzt in einem einzigen Aspose.Slides‑Namespace zusammengeführt. Bitte schauen Sie sich das folgende einfache Code‑Snippet an, das ein normales Diagramm von Grund auf in einer Präsentation mit der Legacy‑Aspose.Slides‑API erstellt, und folgen Sie den Schritten, die die Migration zur neuen zusammengeführten API beschreiben.

Legacy Aspose.Slides for .NET Approach

	//Instanziiere PresentationEx class that represents PPTX file
	using (PresentationEx pres = new PresentationEx())
	{
		//Greife auf first slide
		SlideEx sld = pres.Slides[0];

		// Diagram with default data
		ChartEx chart = sld.Shapes.AddChart(ChartTypeEx.ClusteredColumn, 0, 0, 500, 500);

		//Diagrammtitel festlegen
		chart.ChartTitle.Text.Text = "Sample Title";
		chart.ChartTitle.Text.CenterText = true;
		chart.ChartTitle.Height = 20;
		chart.HasTitle = true;

		//Erste Serie auf Show Values setzen
		chart.ChartData.Series[0].Labels.ShowValue = true;

		//Index des chart data sheet festlegen 
		int defaultWorksheetIndex = 0;

		//Diagrammdaten worksheet abrufen
		ChartDataCellFactory fact = chart.ChartData.ChartDataCellFactory;

		//Standardmäßig generierte series and categories löschen
		chart.ChartData.Series.Clear();
		chart.ChartData.Categories.Clear();
		int s = chart.ChartData.Series.Count;
		s = chart.ChartData.Categories.Count;

		//Neue series hinzufügen
		chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.Type);
		chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.Type);

		//Neue categories hinzufügen
		chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
		chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
		chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));

		//Erste chart series übernehmen
		ChartSeriesEx series = chart.ChartData.Series[0];

		//Jetzt populating series data
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 1, 1, 20));
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 2, 1, 50));
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 3, 1, 30));

		//Füllfarbe für series festlegen
		series.Format.Fill.FillType = FillTypeEx.Solid;
		series.Format.Fill.SolidFillColor.Color = Color.Red;


		//Zweite chart series übernehmen
		series = chart.ChartData.Series[1];

		//Jetzt populating series data
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 1, 2, 30));
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 2, 2, 10));
		series.Values.Add(fact.GetCell(defaultWorksheetIndex, 3, 2, 60));

		//Füllfarbe für series festlegen
		series.Format.Fill.FillType = FillTypeEx.Solid;
		series.Format.Fill.SolidFillColor.Color = Color.Green;


		//Benutzerdefinierte labels für each of categories für new series erstellen

		//Erste label will be show Category name
		DataLabelEx lbl = new DataLabelEx(series);
		lbl.ShowCategoryName = true;
		lbl.Id = 0;
		series.Labels.Add(lbl);

		//Serie-Name für second label anzeigen
		lbl = new DataLabelEx(series);
		lbl.ShowSeriesName = true;
		lbl.Id = 1;
		series.Labels.Add(lbl);

		//Wert für third label anzeigen
		lbl = new DataLabelEx(series);
		lbl.ShowValue = true;
		lbl.ShowSeriesName = true;
		lbl.Separator = "/";
		lbl.Id = 2;
		series.Labels.Add(lbl);

		//Wert und custom text anzeigen
		lbl = new DataLabelEx(series);
		lbl.TextFrame.Text = "My text";
		lbl.Id = 3;
		series.Labels.Add(lbl);

		//Präsentation mit chart speichern
		pres.Write(@"D:\AsposeChart.pptx");
	}

New Aspose.Slides for .NET 13.x Approach

//Instanziiere Presentation-Klasse, die PPTX-Datei repräsentiert//Instanziiere Presentation-Klasse, die PPTX-Datei repräsentiert
Presentation pres = new Presentation();

//Greife auf die erste Folie zu
ISlide sld = pres.Slides[0];

// Diagramm mit Standarddaten hinzufügen
IChart chart = sld.Shapes.AddChart(ChartType.ClusteredColumn, 0, 0, 500, 500);

//Diagrammtitel festlegen
//chart.ChartTitle.TextFrameForOverriding.Text = "Sample Title";
chart.ChartTitle.AddTextFrameForOverriding("Sample Title");
chart.ChartTitle.TextFrameForOverriding.TextFrameFormat.CenterText = NullableBool.True;
chart.ChartTitle.Height = 20;
chart.HasTitle = true;

//Erste Serie auf Werte anzeigen setzen
chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowValue = true;

//Index des Diagrammdatentabells festlegen
int defaultWorksheetIndex = 0;

//Diagrammdaten-Arbeitsblatt abrufen
IChartDataWorkbook fact = chart.ChartData.ChartDataWorkbook;

//Standardmäßig erzeugte Serien und Kategorien löschen
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
int s = chart.ChartData.Series.Count;
s = chart.ChartData.Categories.Count;

//Neue Serien hinzufügen
chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.Type);
chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.Type);

//Neue Kategorien hinzufügen
chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));

//Erste Diagrammserie übernehmen
IChartSeries series = chart.ChartData.Series[0];

//Jetzt die Seriendaten befüllen

series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 1, 1, 20));
series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 2, 1, 50));
series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 3, 1, 30));

//Füllfarbe für Serie festlegen
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = Color.Red;


//Zweite Diagrammserie übernehmen
series = chart.ChartData.Series[1];

//Jetzt die Seriendaten befüllen
series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 1, 2, 30));
series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 2, 2, 10));
series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 3, 2, 60));

//Füllfarbe für Serie festlegen
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = Color.Green;


//Benutzerdefinierte Beschriftungen für jede Kategorie der neuen Serien erstellen

//Erste Beschriftung zeigt den Kategorienamen
IDataLabel lbl = series.DataPoints[0].Label;
lbl.DataLabelFormat.ShowCategoryName = true;

lbl = series.DataPoints[1].Label;
lbl.DataLabelFormat.ShowSeriesName = true;

//Wert für die dritte Beschriftung anzeigen
lbl = series.DataPoints[2].Label;
lbl.DataLabelFormat.ShowValue = true;
lbl.DataLabelFormat.ShowSeriesName = true;
lbl.DataLabelFormat.Separator = "/";

//Präsentation mit Diagramm speichern
pres.Save("AsposeChart.pptx", SaveFormat.Pptx);

Bitte schauen Sie sich das folgende einfache Code‑Snippet an, das ein Streudiagramm von Grund auf in einer Präsentation mit der Legacy‑Aspose.Slides‑API erstellt, und wie es mit der neuen zusammengeführten API erreicht wird.

Legacy Aspose.Slides for .NET Approach

using (PresentationEx pres = new PresentationEx())
{
    SlideEx slide = pres.Slides[0];

    //Erstellen des Standarddiagramms
    ChartEx chart = slide.Shapes.AddChart(ChartTypeEx.ScatterWithSmoothLines, 0, 0, 400, 400);

    //Abrufen des Index des Standard-Datenarbeitsblatts des Diagramms
    int defaultWorksheetIndex = 0;

    //Zugriff auf das Diagramm-Datenarbeitsblatt
    ChartDataCellFactory fact = chart.ChartData.ChartDataCellFactory;

    //Demo-Serien löschen
    chart.ChartData.Series.Clear();

    //Neue Serien hinzufügen
    chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 1, 1, "Series 1"), chart.Type);
    chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 1, 3, "Series 2"), chart.Type);

    //Erste Diagrammserie übernehmen
    ChartSeriesEx series = chart.ChartData.Series[0];

    //Neuen Punkt (1:3) dort hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 2, 1, 1));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 2, 2, 3));

    //Neuen Punkt (2:10) hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 3, 1, 2));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 3, 2, 10));

    //Typ der Serie bearbeiten
    series.Type = ChartTypeEx.ScatterWithStraightLinesAndMarkers;

    //Diagrammserien-Marker ändern
    series.MarkerSize = 10;
    series.MarkerSymbol = MarkerStyleTypeEx.Star;

    //Zweite Diagrammserie übernehmen
    series = chart.ChartData.Series[1];

    //Neuen Punkt (5:2) dort hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 2, 3, 5));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 2, 4, 2));

    //Neuen Punkt (3:1) hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 3, 3, 3));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 3, 4, 1));

    //Neuen Punkt (2:2) hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 4, 3, 2));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 4, 4, 2));

    //Neuen Punkt (5:1) hinzufügen.
    series.XValues.Add(fact.GetCell(defaultWorksheetIndex, 5, 3, 5));
    series.YValues.Add(fact.GetCell(defaultWorksheetIndex, 5, 4, 1));

    //Diagrammserien-Marker ändern
    series.MarkerSize = 10;
    series.MarkerSymbol = MarkerStyleTypeEx.Circle;

    pres.Write("D:\\AsposeSeriesChart.pptx");
}

New Aspose.Slides for .NET 13.x Approach

Presentation pres = new Presentation();

ISlide slide = pres.Slides[0];

//Erstellen des Standarddiagramms
IChart chart = slide.Shapes.AddChart(ChartType.ScatterWithSmoothLines, 0, 0, 400, 400);

//Abrufen des Index des Standard-Datenarbeitsblatts des Diagramms
int defaultWorksheetIndex = 0;

//Zugriff auf das Diagramm-Datenarbeitsblatt
IChartDataWorkbook fact = chart.ChartData.ChartDataWorkbook;

//Demo-Serien löschen
chart.ChartData.Series.Clear();

//Neue Serien hinzufügen
chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 1, 1, "Series 1"), chart.Type);
chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 1, 3, "Series 2"), chart.Type);

//Erste Diagrammserie übernehmen
IChartSeries series = chart.ChartData.Series[0];

//Neuen Punkt (1:3) dort hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 2, 1, 1), fact.GetCell(defaultWorksheetIndex, 2, 2, 3));

//Neuen Punkt (2:10) hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 3, 1, 2), fact.GetCell(defaultWorksheetIndex, 3, 2, 10));

//Typ der Serie bearbeiten
series.Type = ChartType.ScatterWithStraightLinesAndMarkers;

//Diagrammserien-Marker ändern
series.Marker.Size = 10;
series.Marker.Symbol = MarkerStyleType.Star;

//Zweite Diagrammserie übernehmen
series = chart.ChartData.Series[1];

//Neuen Punkt (5:2) dort hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 2, 3, 5), fact.GetCell(defaultWorksheetIndex, 2, 4, 2));

//Neuen Punkt (3:1) hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 3, 3, 3), fact.GetCell(defaultWorksheetIndex, 3, 4, 1));

//Neuen Punkt (2:2) hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 4, 3, 2), fact.GetCell(defaultWorksheetIndex, 4, 4, 2));

//Neuen Punkt (5:1) hinzufügen.
series.DataPoints.AddDataPointForScatterSeries(fact.GetCell(defaultWorksheetIndex, 5, 3, 5), fact.GetCell(defaultWorksheetIndex, 5, 4, 1));

//Diagrammserien-Marker ändern
series.Marker.Size = 10;
series.Marker.Symbol = MarkerStyleType.Circle;

pres.Save("AsposeScatterChart.pptx", SaveFormat.Pptx);

So fügen Sie Header & Footer zu Präsentationen in .NET hinzu Öffentliche API und rückwärtsinkompatible Änderungen in Aspose.Slides für .NET 14.2.0