Diagramm-Arbeitsblatt-Formeln in Präsentationen in .NET anwenden
Übersicht
PowerPoint‑Diagramme speichern ihre Quelldaten in der Regel in einem eingebetteten Arbeitsblatt. In Aspose.Slides für .NET können Sie über die Diagrammdaten‑Arbeitsmappe auf dieses Arbeitsblatt zugreifen, Eingabewerte schreiben, Formeln Zellen zuweisen, unterstützte Formeln berechnen und die berechneten Zellen als Diagrammdaten verwenden.
Dieser Artikel erklärt den kompletten Formelfluss: Erstellen eines Diagramms, Befüllen des Arbeitsblatts, Zuweisen von A1‑ oder R1C1‑Formeln, erneutes Berechnen, Auslesen der berechneten Werte, Verbinden dieser Zellen mit einer Diagrammserie und Speichern der Präsentation. Außerdem wird die unterstützte Formelsyntax, das eingebaute Funktions‑Subset, zwischengespeicherte Werte, nicht unterstützte Formeln und tabellenspezifische Fehlermeldungen beschrieben.
Diagramm‑Arbeitsblätter und Formeln
Ein Diagramm‑Arbeitsblatt enthält die Kategorien, Seriennamen und Werte, die ein Diagramm verwendet. In PowerPoint können Sie das Arbeitsblatt inspizieren, indem Sie den Diagrammdaten‑Editor öffnen:
In Aspose.Slides wird das Arbeitsblatt über das Diagrammdaten‑Arbeitsmappe bereitgestellt. Verwenden Sie die Formula-Eigenschaft für A1‑Formeln und die R1C1Formula-Eigenschaft für R1C1‑Formeln. Nachdem Sie Eingabezellen oder Formeln geändert haben, rufen Sie CalculateFormulas auf, um unterstützte Formeln neu zu berechnen und die entsprechenden Zellenwerte zu aktualisieren.
Eine berechnete Zelle gibt ihr Ergebnis weiterhin über die Value-Eigenschaft zurück. Das ist wichtig, wenn Sie das Formelergebnis im Code prüfen oder die Zelle als Diagrammdatenpunkt verwenden müssen.
Erstellen eines Diagramms und Berechnen von Arbeitsblatt‑Formeln
Das folgende Beispiel demonstriert einen End‑zu‑End‑Workflow. Es erstellt ein gruppiertes Säulendiagramm, löscht die Beispieldaten, schreibt quartalsweise Umsatz‑ und Aufwandswerte, berechnet den Gewinn mit Formeln, liest die Ergebnisse aus, verwendet die berechneten Zellen als Diagrammwerte und speichert die Präsentation.
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 600, 350);
var workbook = chart.ChartData.ChartDataWorkbook;
var worksheetIndex = 0;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
workbook.Clear(worksheetIndex);
var category1 = workbook.GetCell(worksheetIndex, "A2", "Q1");
var category2 = workbook.GetCell(worksheetIndex, "A3", "Q2");
var category3 = workbook.GetCell(worksheetIndex, "A4", "Q3");
workbook.GetCell(worksheetIndex, "B1", "Revenue");
workbook.GetCell(worksheetIndex, "C1", "Expenses");
workbook.GetCell(worksheetIndex, "D1", "Profit");
workbook.GetCell(worksheetIndex, "B2").Value = 120.0;
workbook.GetCell(worksheetIndex, "C2").Value = 80.0;
workbook.GetCell(worksheetIndex, "B3").Value = 150.0;
workbook.GetCell(worksheetIndex, "C3").Value = 95.0;
workbook.GetCell(worksheetIndex, "B4").Value = 135.0;
workbook.GetCell(worksheetIndex, "C4").Value = 110.0;
var profit1 = workbook.GetCell(worksheetIndex, "D2");
var profit2 = workbook.GetCell(worksheetIndex, "D3");
var profit3 = workbook.GetCell(worksheetIndex, "D4");
profit1.Formula = "B2-C2";
profit2.Formula = "B3-C3";
profit3.Formula = "B4-C4";
workbook.CalculateFormulas();
var q1Profit = Convert.ToDouble(profit1.Value); // 40
var q2Profit = Convert.ToDouble(profit2.Value); // 55
var q3Profit = Convert.ToDouble(profit3.Value); // 25
Console.WriteLine($"Q1 profit: {q1Profit}");
Console.WriteLine($"Q2 profit: {q2Profit}");
Console.WriteLine($"Q3 profit: {q3Profit}");
chart.ChartData.Categories.Add(category1);
chart.ChartData.Categories.Add(category2);
chart.ChartData.Categories.Add(category3);
var profitSeries = chart.ChartData.Series.Add(workbook.GetCell(worksheetIndex, "D1"), chart.Type);
profitSeries.DataPoints.AddDataPointForBarSeries(profit1);
profitSeries.DataPoints.AddDataPointForBarSeries(profit2);
profitSeries.DataPoints.AddDataPointForBarSeries(profit3);
profitSeries.Labels.DefaultDataLabelFormat.ShowValue = true;
presentation.Save("chart-formulas.pptx", SaveFormat.Pptx);
Die Diagrammdatenpunkte verweisen auf D2:D4, sodass das Diagramm die berechneten Gewinnwerte nutzt. Es gibt keinen separaten Diagramm‑Aktualisierungsaufruf in diesem Workflow: Berechnen Sie zuerst die Arbeitsmappe, dann verwenden oder speichern Sie die Diagrammdaten, die auf die berechneten Zellen zeigen.
Verwendung von A1‑Formeln
Die A1‑Notation identifiziert Spalten mit Buchstaben und Zeilen mit Zahlen. Weisen Sie A1‑Ausdrücke über IChartDataCell.Formula zu.
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.GetCell(0, "C3").Value = 10;
workbook.GetCell(0, "F2").Value = 2;
workbook.GetCell(0, "G2").Value = 3;
workbook.GetCell(0, "H2").Value = 4;
var cell = workbook.GetCell(0, "A2");
cell.Formula = "C3+SUM(F2:H2)";
workbook.CalculateFormulas();
var value = cell.Value; // 19
Häufige A1‑Referenzformen sind:
| Referenz | Relativ | Absolut | Gemischt |
|---|---|---|---|
| Zelle | A2 |
$A$2 |
A$2, $A2 |
| Zeile | 2:2 |
$2:$2 |
— |
| Spalte | A:A |
$A:$A |
— |
| Bereich | A2:C4 |
$A$2:$C$4 |
A$2:$C4, $A2:C$4 |
Relative Verweise können sich ändern, wenn eine Formel von einer Tabellenkalkulation verschoben oder kopiert wird. Absolute Verweise behalten beide Koordinaten fest, während gemischte Verweise nur eine Zeile oder eine Spalte fixieren.
Verwendung von R1C1‑Formeln
Die R1C1‑Notation identifiziert sowohl Zeilen als auch Spalten numerisch. Relative Verweise verwenden Offsets in eckigen Klammern. Weisen Sie diese Syntax über IChartDataCell.R1C1Formula zu.
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.GetCell(0, "B2").Value = 12;
workbook.GetCell(0, "C2").Value = 5;
var cell = workbook.GetCell(0, "D2");
cell.R1C1Formula = "RC[-2]-RC[-1]";
workbook.CalculateFormulas();
var value = cell.Value; // 7
Häufige R1C1‑Referenzformen sind:
| Referenz | Relativ | Absolut | Gemischt |
|---|---|---|---|
| Zelle | R[2]C[3] |
R2C3 |
R2C[3], R[2]C3 |
| Zeile | R[2] |
R2 |
— |
| Spalte | C[3] |
C3 |
— |
| Bereich | R[2]C[3]:R[5]C[7] |
R2C3:R5C7 |
R2C3:R[5]C[7], R[2]C3:R5C[7] |
Beispiel: In Zelle D2 bedeutet RC[-2] die Zelle in derselben Zeile, zwei Spalten links (B2).
Formel‑Konstanten und Operatoren
Der eingebaute Formelauswerter unterstützt logische Werte, numerische Literale, Zeichenketten, tabellenspezifische Fehlwerte, arithmetische Operatoren und Vergleichsoperatoren.
Konstanten und Literale
| Typ | Beispiele | Hinweise |
|---|---|---|
| Logisch | TRUE, FALSE |
Können direkt in logischen Ausdrücken wie A2=TRUE verwendet werden. |
| Numerisch | 1, 0.5, .3, 1E-2 |
Dezimal‑ und wissenschaftliche Notation werden unterstützt. |
| Zeichenkette | "abc", "2/3/2020 12:00" |
Text‑Literalwerte werden innerhalb der Formel in doppelte Anführungszeichen gesetzt. |
| Fehlerwert | #DIV/0!, #N/A, #REF! |
Eine gültige Formel kann statt eines normalen Ergebnisses einen Tabellen‑Fehlerwert ergeben. |
Dieses Beispiel verwendet mehrere Konstantentypen:
using Aspose.Slides;
using Aspose.Slides.Charts;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
var workbook = chart.ChartData.ChartDataWorkbook;
workbook.GetCell(0, "A2").Value = false;
workbook.GetCell(0, "B2").Formula = "A2=TRUE";
workbook.GetCell(0, "C2").Formula = "1+0.5";
workbook.GetCell(0, "D2").Formula = ".3*1E-2";
workbook.GetCell(0, "E2").Formula = "\"abc\"";
workbook.GetCell(0, "F2").Formula = "2/0";
workbook.CalculateFormulas();
var logicalValue = workbook.GetCell(0, "B2").Value; // Falsch
var numericValue = workbook.GetCell(0, "C2").Value; // 1.5
var scientificValue = workbook.GetCell(0, "D2").Value; // 0.003
var stringValue = workbook.GetCell(0, "E2").Value; // abc
var errorValue = workbook.GetCell(0, "F2").Value; // #DIV/0!
Arithmetische Operatoren
| Operator | Bedeutung | Beispiel |
|---|---|---|
+ |
Addition oder Vorzeichen‑Plus | 2+3 |
- |
Subtraktion oder Negation | 2-3, -3 |
* |
Multiplikation | 2*3 |
/ |
Division | 2/3 |
% |
Prozent | 30% |
^ |
Potenzierung | 2^3 |
Verwenden Sie Klammern, um die Auswertungsreihenfolge explizit zu machen, z. B. (A2+B2)*C2.
Vergleichsoperatoren
Vergleichsausdrücke liefern logische Werte.
| Operator | Bedeutung | Beispiel |
|---|---|---|
= |
Gleich | A2=3 |
<> |
Ungleich | A2<>3 |
> |
Größer als | A2>3 |
>= |
Größer oder gleich | A2>=3 |
< |
Kleiner als | A2<3 |
<= |
Kleiner oder gleich | A2<=3 |
Unterstützte vordefinierte Funktionen
Aspose.Slides enthält einen eingebauten Formelauswerter für Diagramm‑Arbeitsblätter, ist jedoch keine vollständige Excel‑Rechenengine. Der dokumentierte Funktionsumfang ist auf die unten aufgeführten Funktionen beschränkt. Gehen Sie nicht davon aus, dass eine beliebige Excel‑Funktion von CalculateFormulas neu berechnet werden kann.
| Funktion | Zweck oder unterstützte Form | Beispiel |
|---|---|---|
ABS |
Absoluter Wert | ABS(A2) |
AVERAGE |
Arithmetisches Mittel | AVERAGE(B2:B5) |
CEILING |
Auf ein Vielfaches aufrunden | CEILING(A2,5) |
CHOOSE |
Wert nach Index auswählen | CHOOSE(A2,"Low","High") |
CONCAT |
Textwerte verketten | CONCAT(A2,B2) |
CONCATENATE |
Textwerte verketten | CONCATENATE(A2," ",B2) |
DATE |
Datum über das 1900‑Datumssystem erstellen | DATE(2026,8,19) |
DAYS |
Anzahl der Tage zwischen Daten | DAYS(B2,A2) |
FIND |
Textwert in anderem finden | FIND("-",A2) |
FINDB |
Byte‑orientierte Textsuche | FINDB("a",A2) |
IF |
Bedingtes Ergebnis | IF(A2>0,A2,0) |
INDEX |
Referenzform | INDEX(A2:C4,2,3) |
LOOKUP |
Vektorform | LOOKUP(A2,B2:B5,C2:C5) |
MATCH |
Vektorform | MATCH(A2,B2:B5,0) |
MAX |
Maximalwert | MAX(B2:B5) |
SUM |
Summe | SUM(B2:B5) |
VLOOKUP |
Vertikaler SVERWEIS | VLOOKUP(A2,B2:D10,3,FALSE) |
Die in der Tabelle gezeigten Einschränkungen sind bedeutend: INDEX ist in der Referenzform dokumentiert, während LOOKUP und MATCH in ihrer Vektorform dokumentiert sind. DATE verwendet das 1900‑Datumssystem. Funktionen, die hier nicht aufgelistet sind, gelten als nicht von Aspose.Slides unterstützt, sofern sie nicht separat dokumentiert sind.
Formeln mit einer bevorzugten Kultur berechnen
Einige Arbeitsblatt‑Funktionen interpretieren Text nach kulturspezifischen Regeln. Das ist besonders wichtig für Funktionen, die für Sprachen mit Doppelbyte‑Zeichensätzen (DBCS) vorgesehen sind. Um solche Formeln korrekt zu berechnen, erstellen Sie ein LoadOptions-Objekt, setzen Sie ISpreadsheetOptions.PreferredCulture über LoadOptions.SpreadsheetOptions und laden dann die Präsentation.
Das folgende Beispiel wählt die japanische Kultur, öffnet eine Präsentation mit den konfigurierten Ladeoptionen und ruft IChartDataWorkbook.CalculateFormulas für jedes Diagramm‑Arbeitsblatt auf:
using System.Globalization;
using Aspose.Slides;
using Aspose.Slides.Charts;
var loadOptions = new LoadOptions
{
SpreadsheetOptions = new SpreadsheetOptions
{
PreferredCulture = CultureInfo.GetCultureInfo("ja-JP")
}
};
using var presentation = new Presentation("presentation.pptx", loadOptions);
foreach (var slide in presentation.Slides)
{
foreach (var shape in slide.Shapes)
{
if (shape is IChart chart)
{
chart.ChartData.ChartDataWorkbook.CalculateFormulas();
}
}
}
Die bevorzugte Kultur ist Teil der Präsentations‑Ladekonfiguration, also geben Sie sie an, bevor Sie die Presentation-Instanz erstellen. Verwenden Sie die Kultur, die von den Arbeitsblatt‑Formeln erwartet wird; zum Beispiel ja-JP für Formeln, die japanische DBCS‑Berechnungsregeln befolgen sollen.
Neuberechnung und zwischengespeicherte Werte
Tabellen‑Dateien speichern häufig sowohl eine Formel als auch deren zuletzt berechneten Wert. Aspose.Slides kann daher einen zwischengespeicherten Wert aus IChartDataCell.Value lesen, wenn eine Präsentation geladen wird und die zugehörigen Diagrammdaten nicht geändert wurden.
Nachdem Sie Eingabezellen oder Formeln geändert haben, dürfen Sie sich nicht auf ein altes Zwischenspeicher‑Ergebnis verlassen. Rufen Sie IChartDataWorkbook.CalculateFormulas auf, bevor Sie berechnete Werte auslesen oder Diagrammdaten speichern, die von ihnen abhängen.
Für Formeln außerhalb des unterstützten Subsets kann Aspose.Slides die Formel möglicherweise nicht parsen oder ihre Abhängigkeiten nicht ermitteln. Wurde die Arbeitsmappe geändert, ist der vorherige Zwischenspeicherwert nicht mehr zuverlässig. In diesem Fall kann das Auslesen des Werts einer Zelle mit nicht unterstützten Daten die Ausnahme CellUnsupportedDataException auslösen.
Falls Ihr Diagramm von Excel‑Funktionen abhängt, die Aspose.Slides nicht auswertet, berechnen Sie diese Formeln mit einer Tabellen‑Engine, die sie unterstützt, und schreiben Sie die resultierenden Werte zurück in die Diagramm‑Arbeitsmappe. Ersetzen Sie nicht‑unterstützte Formeln nicht durch geschätzte Werte.
Umgang mit Formel‑Fehlern
Es gibt zwei unterschiedliche Arten von Problemen.
Eine Formel kann gültig sein, aber ein Tabellen‑Fehlerergebnis wie #DIV/0!, #N/A, #NAME?, #NULL!, #NUM!, #REF! oder #VALUE! erzeugen. In diesem Fall ist das Fehlertoken ein Zellen‑Ergebnis und kann über Value zurückgegeben werden.
Eine Formel kann zudem beim Parsen, bei Referenzen, Abhängigkeiten oder bei nicht unterstützten Daten fehlschlagen. Aspose.Slides bietet dafür tabellenspezifische Ausnahmen: CellInvalidFormulaException, CellInvalidReferenceException, CellCircularReferenceException und CellUnsupportedDataException.
Wenn Formeln aus Vorlagen oder Benutzereingaben stammen, fangen Sie diese Ausnahmen beim Neuberechnen und beim Zugriff auf Werte ab:
using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Spreadsheet;
using var presentation = new Presentation();
var slide = presentation.Slides[0];
var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
var workbook = chart.ChartData.ChartDataWorkbook;
var cell = workbook.GetCell(0, "A2");
cell.Formula = "SUM(B2:B5)";
try
{
workbook.CalculateFormulas();
Console.WriteLine(cell.Value);
}
catch (CellInvalidFormulaException ex)
{
Console.Error.WriteLine($"Invalid formula: {ex.Message}");
}
catch (CellInvalidReferenceException ex)
{
Console.Error.WriteLine($"Invalid cell reference: {ex.Message}");
}
catch (CellCircularReferenceException ex)
{
Console.Error.WriteLine($"Circular reference: {ex.Message}");
}
catch (CellUnsupportedDataException ex)
{
Console.Error.WriteLine($"Unsupported spreadsheet data: {ex.Message}");
}
Praktische Beschränkungen
Die Formelunterstützung in Diagramm‑Arbeitsblättern ist für einen definierten Subset von Tabellenberechnungen gedacht, nicht für vollständige Excel‑Kompatibilität. Berücksichtigen Sie diese Einschränkungen beim Entwurf eines Reporting‑Workflows:
- Verwenden Sie nur die dokumentierten Konstanten, Operatoren, Referenzen und Funktionen, wenn Aspose.Slides Formeln neu berechnen soll.
- Berechnen Sie nach Änderungen von Zellen, von denen Formelergebnisse abhängen, neu.
- Betrachten Sie zwischengespeicherte Werte aus geladenen Präsentationen als Schnappschüsse, nicht als Ersatz für eine Neuberechnung nach Änderungen.
- Testen Sie Formeln aus bestehenden Vorlagen, bevor Sie sich auf deren berechnete Werte verlassen, insbesondere wenn sie Funktionen außerhalb der dokumentierten Liste nutzen.
- Für Formeln, die eine vollständige Tabellen‑Rechenengine erfordern, berechnen Sie sie extern und aktualisieren anschließend die Diagramm‑Arbeitsmappe mit den resultierenden Werten.
FAQ
Was ist der Unterschied zwischen Formula und R1C1Formula?
Formula speichert einen A1‑Stil‑Ausdruck wie B2-C2. R1C1Formula speichert einen R1C1‑Stil‑Ausdruck wie RC[-2]-RC[-1]. Verwenden Sie die Notation, die am besten zu Ihrer Erzeugungs‑ oder Kopierlogik passt.
Muss ich die Zelle selbst oder ihren Wert nach der Berechnung lesen?
IChartDataWorkbook.GetCell liefert ein IChartDataCell. Um das berechnete Ergebnis zu erhalten, lesen Sie nach der Neuberechnung die Value-Eigenschaft dieser Zelle.
Wann sollte ich CalculateFormulas aufrufen?
Rufen Sie CalculateFormulas nach Änderungen von Eingabewerten oder Formeln und bevor Sie von den berechneten Ergebnissen abhängen, auf. Damit werden die Werte der von dem integrierten Auswerter unterstützten Formeln aktualisiert.
Unterstützt Aspose.Slides jede Excel‑Funktion?
Nein. Der integrierte Auswerter unterstützt nur ein dokumentiertes Subset von Funktionen. Funktionen außerhalb dieses Subsets sollten nicht als korrekt neu berechenbar angenommen werden. Wenn vollständige Excel‑Formel‑Kompatibilität nötig ist, führen Sie die Berechnung mit einer geeigneten Tabellen‑Engine durch und schreiben Sie die finalen Werte in die Diagramm‑Arbeitsmappe.
Was passiert, wenn eine geladene Präsentation eine nicht unterstützte Formel enthält?
Wenn die Diagrammdaten nicht geändert wurden, kann die Arbeitsmappe noch einen zuvor berechneten zwischengespeicherten Wert enthalten. Nach einer Änderung der zugehörigen Daten ist dieser zwischengespeicherte Wert möglicherweise nicht mehr gültig. Der Zugriff auf eine Zelle, deren Formel nicht verarbeitet werden kann, kann die Ausnahme CellUnsupportedDataException auslösen.
Sind Formel‑Fehlerwerte identisch mit .NET‑Ausnahmen?
Nein. Ein Ergebnis wie #DIV/0! ist ein Tabellenwert, der durch eine gültige Berechnung erzeugt wurde. Ausnahmen wie CellInvalidFormulaException oder CellCircularReferenceException bedeuten, dass die Formel nicht normal verarbeitet werden kann.
Wird ein Diagramm automatisch aktualisiert, wenn sich eine Formelzelle ändert?
Eine Diagrammserie kann Arbeitsblatt‑Zellen referenzieren. Berechnen Sie zuerst die Arbeitsmappe, dann speichern oder rendern Sie die Präsentation. Wenn die Diagrammdatenpunkte die berechneten Zellen referenzieren, verwendet das Diagramm die aktualisierten Zellwerte; ein separater Aktualisierungs‑Aufruf ist für diesen Workflow nicht erforderlich.
Können Diagramme ein externes Excel‑Arbeitsbuch verwenden?
Ja, Diagrammdaten können über die Diagramm‑Daten‑API so konfiguriert werden, dass sie ein externes Arbeitsbuch nutzen. Der in diesem Artikel beschriebene Formel‑Berechnungs‑Workflow bezieht sich jedoch auf das Diagramm‑Arbeitsbuch und das von Aspose.Slides bewertete Funktions‑Subset. Gehen Sie nicht davon aus, dass CalculateFormulas eine vollständige Neuberechnung beliebiger Formeln in einer externen XLSX‑Datei liefert.
Kann ich Formeln verwenden, die auf ein anderes Arbeitsblatt oder Arbeitsbuch verweisen?
Excel‑artige Verweise können in Diagramm‑Arbeitsmappen vorkommen, aber die Formelauswertung ist durch den unterstützten Parser und Funktionsumfang begrenzt. Wenn ein Bezug über mehrere Blätter oder zu einer externen Datei zwingend erforderlich ist, prüfen Sie die genaue Formel mit Ihrer Ziel‑Aspose.Slides‑Version. Für Workflows, die umfassende Excel‑Referenz‑Kompatibilität benötigen, berechnen Sie das Arbeitsblatt extern und schreiben die aufgelösten Werte zurück in die Diagrammdaten.
Müssen Formel‑Zeichenketten mit = beginnen?
Die Aspose.Slides‑API‑Beispiele setzen Ausdrücke wie B2-C2 oder SUM(B2:B5) ohne führendes =. Die Verwendung dieser Form hält erzeugte Formeln konsistent mit den dokumentierten API‑Beispielen.