.NET のプレゼンテーションでチャート ワークシート数式を適用する
概要
PowerPoint のチャートは通常、埋め込みワークシートに元データを保存します。Aspose.Slides for .NET では、チャート データ ワークブックを介してそのワークシートにアクセスし、入力値を書き込み、セルに数式を割り当て、サポートされている数式を計算し、計算結果のセルをチャート データとして使用できます。
本記事では、チャートの作成、ワークシートへのデータ入力、A1 形式または R1C1 形式の数式割り当て、再計算、計算結果の取得、セルをチャート シリーズに接続、プレゼンテーションの保存という一連の数式ワークフローを説明します。また、サポートされている数式構文、組み込み関数のサブセット、キャッシュ値、未サポートの数式、およびスプレッドシート固有のエラーについても解説します。
チャート ワークシートと数式
チャート ワークシートには、チャートで使用されるカテゴリ、系列名、値が格納されています。PowerPoint では、チャート データ エディターを開くことでワークシートを確認できます。
Aspose.Slides では、ワークシートはチャート データ ワークブックを介して公開されます。A1 形式の数式にはFormulaプロパティを、R1C1 形式の数式にはR1C1Formulaプロパティを使用します。入力セルまたは数式を変更した後は、CalculateFormulasを呼び出してサポートされている数式を再計算し、対応するセル値を更新します。
計算済みセルは依然としてValueプロパティで結果を取得できます。コードで数式結果を確認したり、セルをチャート データ ポイントとして使用したりする際に重要です。
チャートの作成とワークシート数式の計算
以下の例はエンドツーエンドのワークフローを示します。クラスター化縦棒グラフを作成し、サンプル データをクリアし、四半期ごとの収益と費用の値を書き込み、数式で利益を計算し、結果を読み取り、計算済みセルをチャート値として使用し、プレゼンテーションを保存します。
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);
チャート データ ポイントは D2:D4 を参照しているため、チャートは計算された利益値を使用します。このワークフローでは別途チャート更新呼び出しは不要です。まずワークブックを再計算し、次に計算結果を指すチャート データを使用または保存します。
A1 形式の数式を使用する
A1 表記は列を文字、行を数字で識別します。IChartDataCell.Formulaを通じて A1 形式の式を割り当てます。
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
一般的な A1 参照形式は次のとおりです。
| 参照 | 相対 | 絶対 | 混合 |
|---|---|---|---|
| セル | A2 |
$A$2 |
A$2, $A2 |
| 行 | 2:2 |
$2:$2 |
— |
| 列 | A:A |
$A:$A |
— |
| 範囲 | A2:C4 |
$A$2:$C$4 |
A$2:$C4, $A2:C$4 |
相対参照は数式を移動またはコピーしたときに変化します。絶対参照は両方の座標を固定し、混合参照は行または列のいずれかのみを固定します。
R1C1 形式の数式を使用する
R1C1 表記は行と列を数値で識別します。相対参照は角括弧でオフセットを表します。IChartDataCell.R1C1Formulaを通じてこの構文を割り当てます。
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
一般的な R1C1 参照形式は次のとおりです。
| 参照 | 相対 | 絶対 | 混合 |
|---|---|---|---|
| セル | R[2]C[3] |
R2C3 |
R2C[3], R[2]C3 |
| 行 | R[2] |
R2 |
— |
| 列 | C[3] |
C3 |
— |
| 範囲 | R[2]C[3]:R[5]C[7] |
R2C3:R5C7 |
R2C3:R[5]C[7], R[2]C3:R5C[7] |
たとえば、セル D2 で RC[-2] は同じ行の左 2 列のセル（B2）を指します。
数式定数と演算子
組み込みの数式評価エンジンは、論理値、数値リテラル、文字列、スプレッドシート エラー値、算術演算子、比較演算子をサポートします。
定数とリテラル
| 種類 | 例 | 補足 |
|---|---|---|
| 論理 | TRUE, FALSE |
A2=TRUE のような論理式で直接使用できます。 |
| 数値 | 1, 0.5, .3, 1E-2 |
通常表記と指数表記の両方がサポートされます。 |
| 文字列 | "abc", "2/3/2020 12:00" |
文字列リテラルは式内で二重引用符で囲みます。 |
| エラー結果 | #DIV/0!, #N/A, #REF! |
有効な数式でもスプレッドシート エラー値を返すことがあります。 |
この例は複数の定数タイプを使用しています。
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; // 偽
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!
算術演算子
| 演算子 | 意味 | 例 |
|---|---|---|
+ |
加算または単項プラス | 2+3 |
- |
減算または単項マイナス | 2-3, -3 |
* |
乗算 | 2*3 |
/ |
除算 | 2/3 |
% |
パーセント | 30% |
^ |
累乗 | 2^3 |
評価順序を明示したい場合は括弧を使用します。例: (A2+B2)*C2。
比較演算子
比較式は論理値を返します。
| 演算子 | 意味 | 例 |
|---|---|---|
= |
等しい | A2=3 |
<> |
等しくない | A2<>3 |
> |
大きい | A2>3 |
>= |
以上 | A2>=3 |
< |
小さい | A2<3 |
<= |
以下 | A2<=3 |
サポートされている組み込み関数
Aspose.Slides にはチャート ワークシート用の組み込み数式評価エンジンがありますが、完全な Excel 計算エンジンではありません。以下に示す関数のみがドキュメント化されており、サポートされています。CalculateFormulasで任意の Excel 関数が再計算できると想定しないでください。
| 関数 | 用途またはサポート形式 | 例 |
|---|---|---|
ABS |
絶対値 | ABS(A2) |
AVERAGE |
算術平均 | AVERAGE(B2:B5) |
CEILING |
指定の倍数に切り上げ | CEILING(A2,5) |
CHOOSE |
インデックスで値を選択 | CHOOSE(A2,"Low","High") |
CONCAT |
テキスト結合 | CONCAT(A2,B2) |
CONCATENATE |
テキスト結合 | CONCATENATE(A2," ",B2) |
DATE |
1900 日付システムで日付値を作成 | DATE(2026,8,19) |
DAYS |
2 つの日付間の日数を返す | DAYS(B2,A2) |
FIND |
テキスト内で別のテキストを検索 | FIND("-",A2) |
FINDB |
バイト指向検索 | FINDB("a",A2) |
IF |
条件結果 | IF(A2>0,A2,0) |
INDEX |
参照形式 | INDEX(A2:C4,2,3) |
LOOKUP |
ベクトル形式 | LOOKUP(A2,B2:B5,C2:C5) |
MATCH |
ベクトル形式 | MATCH(A2,B2:B5,0) |
MAX |
最大値 | MAX(B2:B5) |
SUM |
合計 | SUM(B2:B5) |
VLOOKUP |
縦方向検索 | VLOOKUP(A2,B2:D10,3,FALSE) |
表に示す制限は重要です。INDEX は参照形式で、LOOKUP と MATCH はベクトル形式でドキュメント化されています。DATE は 1900 日付システムを使用します。ここに記載されていない機能や関数は、Aspose.Slides の数式評価エンジンでは未サポートと見なしてください。
優先ロケールでの数式計算
一部のワークブック関数はテキストをロケール固有の規則で解釈します。特にダブルバイト文字セット（DBCS）を使用する言語向け関数で重要です。正しく計算するには、LoadOptions を作成し、LoadOptions.SpreadsheetOptions 経由で ISpreadsheetOptions.PreferredCulture を設定してからプレゼンテーションをロードします。
以下の例は日本語ロケールを選択し、設定したロード オプションでプレゼンテーションを開き、すべてのチャート ワークブックに対して IChartDataWorkbook.CalculateFormulas を呼び出します。
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();
}
}
}
優先ロケールはプレゼンテーション読み込み構成の一部として扱われるため、Presentation インスタンスを作成する前に指定してください。ワークブック数式が期待するロケール（例: 日本語 DBCS 計算規則の場合は ja-JP）を使用します。
再計算とキャッシュ値
スプレッドシート ファイルは通常、数式と最後に計算された値の両方を保存します。Aspose.Slides は、プレゼンテーションがロードされ、該当チャート データが変更されていない場合に IChartDataCell.Value からキャッシュされた値を読み取ります。
入力セルや数式を変更した場合は、古いキャッシュ結果に依存しないでください。計算された値を読み取る前またはそれらに依存するチャート データを保存する前に、IChartDataWorkbook.CalculateFormulas を呼び出します。
サポート外の数式については、Aspose.Slides が数式の解析や依存関係の確立に失敗することがあります。ワークブックが変更された場合、以前のキャッシュ値は信頼できなくなります。そのような状況で未サポート データを持つセルの値を読み取ろうとすると、CellUnsupportedDataException がスローされる可能性があります。
チャートが Aspose.Slides で評価できない Excel 関数に依存している場合は、これらの数式をサポートするスプレッドシート エンジンで計算し、結果の値をチャート ワークブックに書き戻してください。未サポートの数式を推測した値で置き換えてはいけません。
数式エラーの処理
区別すべき問題は大きく 2 種類あります。
- 数式自体は有効だが、
#DIV/0!,#N/A,#NAME?,#NULL!,#NUM!,#REF!,#VALUE!などのスプレッドシート エラー結果を返す場合。この場合エラー トークンはセルの結果であり、Valueを通じて取得できます。 - パース、参照、依存関係、またはサポートデータのレベルで数式が失敗する場合。Aspose.Slides はこれらのケースに対して CellInvalidFormulaException、CellInvalidReferenceException、CellCircularReferenceException、CellUnsupportedDataException といったスプレッドシート固有の例外を提供します。
テンプレートやユーザー入力から数式が供給される場合は、再計算および値取得時にこれらの例外を捕捉してください。
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}");
}
実用上の制限
チャート ワークシートでの数式サポートは、完全な Excel 互換性ではなく、定義されたサブセットのスプレッドシート計算を対象としています。レポート ワークフローを設計する際は以下の点に留意してください。
- Aspose.Slides に数式再計算を委ねる場合は、ドキュメント化された定数、演算子、参照、関数のみを使用してください。
- 数式結果が依存するセルを変更したら必ず再計算してください。
- ロードされたプレゼンテーションから取得したキャッシュ値はスナップショットであり、編集後の再計算の代替とはみなせません。
- 既存テンプレートの数式は、ドキュメント化されたリスト外の関数を使用していないか事前にテストしてください。
- 完全なスプレッドシート計算エンジンが必要な数式は、外部で計算し、結果の値でチャート ワークブックを更新してください。
FAQ
Formula と R1C1Formula の違いは何ですか？
Formula は B2-C2 のような A1 形式の式を保持します。R1C1Formula は RC[-2]-RC[-1] のような R1C1 形式の式を保持します。生成またはコピーする数式に最も合う表記を使用してください。
計算後にセル自体と値のどちらを読むべきですか？
IChartDataWorkbook.GetCell は IChartDataCell を返します。再計算後にそのセルの Value プロパティを読むことで計算結果を取得できます。
CalculateFormulas はいつ呼び出すべきですか？
入力値または数式を変更した後、計算結果に依存する前に CalculateFormulas を呼び出してください。これにより組み込み評価エンジンがサポートする数式の値が更新されます。
Aspose.Slides はすべての Excel 関数をサポートしていますか？
いいえ。組み込み評価エンジンはドキュメント化されたサブセットのみをサポートします。サブセット外の関数は正しく再計算できると想定しないでください。完全な Excel 互換が必要な場合は、別のスプレッドシート エンジンで計算し、最終値をチャート ワークブックに書き込んでください。
ロードされたプレゼンテーションに未サポートの数式が含まれていたらどうなりますか？
チャート データが変更されていない限り、ワークブックは以前に計算されたキャッシュ値を保持している可能性があります。関連データが変更された後は、そのキャッシュ値は無効になることがあります。処理できない数式を持つセルにアクセスすると CellUnsupportedDataException がスローされることがあります。
数式エラー値は .NET 例外と同じですか？
いいえ。#DIV/0! などの結果は有効な計算から得られるスプレッドシートの値です。 CellInvalidFormulaException や CellCircularReferenceException といった例外は、数式自体が正常に処理できないことを示します。
数式セルが変更されたときにチャートは自動的に更新されますか？
チャート シリーズはワークブックのセルを参照できます。まずワークブックを再計算し、次にプレゼンテーションを保存またはレンダリングしてください。チャート データ ポイントが計算済みセルを参照していれば、チャートは更新されたセル値を使用します。このワークフローでは別途チャート更新メソッドは不要です。
チャートは外部 Excel ワークブックを使用できますか？
はい、チャート データは API を通じて外部ワークブックを使用するよう構成できます。ただし、本記事で説明する数式計算ワークフローはチャート データ ワークブックと Aspose.Slides が評価できる数式サブセットに限定されます。CalculateFormulas が外部 XLSX ファイルの任意の数式を完全に再計算するとは限らないことに注意してください。
別シートまたは別ブックを参照する数式は使用できますか？
チャート ワークブック内で Excel 形式の参照は可能ですが、評価はサポートされているパーサと関数セットに限定されます。クロスシートや外部参照が必須の場合は、対象の Aspose.Slides バージョンでその数式が正しく評価できるか確認してください。広範な Excel 参照互換性が必要なワークフローでは、ワークブックを外部で計算し、解決済みの値をチャート データに書き戻すことを推奨します。
数式文字列は = で始める必要がありますか？
Aspose.Slides の API 例では B2-C2 や SUM(B2:B5) のように先頭の = を付けずに式を割り当てます。この形式で数式を設定すると、ドキュメント化された API 例と一致します。