.NET でプレゼンテーションのチャート ワークブックを管理する

概要

この記事では、Aspose.Slides のチャート ワークブックの操作方法について説明します。ワークブック ストリームを介してチャート データの読み取りと書き込み、ワークブック セルをチャート データ ラベルとして使用、ワークシート コレクションへのアクセス、チャート値のデータ ソース タイプの指定方法を示します。

また、外部ワークブックをチャート データ ソースとして使用する方法についても取り上げます。サンプルでは、外部ワークブックの作成と割り当て、チャートにリンクされた外部ワークブックのパス取得、ワークブックが利用可能な場合のチャート データの編集方法を示しています。

欠損データを表すワークブック セルについては、空のセルの表示制御で空のセルとゼロの違い、および利用可能な表示モードの折れ線グラフ比較をご覧ください。

非表示行および列からデータを含める

非表示のワークシート行および列からデータをプロットするかどうかは、IChart.PlotVisibleCellsOnly を使用して制御します。true に設定すると表示セルのみをプロットし、false に設定すると表示セルと非表示セルの両方を含めます。この設定はチャートのプロットにのみ影響し、ワークシートの行や列を非表示または表示にするものではありません。

サンプルプレゼンテーション には、最初のスライドの最初の図形として縦棒グラフが含まれています。埋め込みワークシート Sheet1 には、ソース範囲 A1:C4 があり、3 行目と C 列は非表示ですが、セルには値が保持されています。

ワークシート行 A: 月 B: 小売 C: 卸売(非表示列)
2 1月 10 30
3(非表示行) 2月 40 60
4 3月 20 50

IChartData.ChartDataWorkbook を使用してソースセルにアクセスし、IChartDataCell.IsHidden を読み取って非表示ステータスを確認します。このプロパティは読み取り専用です。このファイルでは、B2 は表示され、B3 は非表示行に属し、C2 は非表示列に属します。サンプルはそれぞれ False、True、True を出力します。

この例では、プロット設定を変更した後にチャート データをリフレッシュします: 埋め込みワークブックを ReadWorkbookStream で保持し、WriteWorkbookStream で再ロードします。すべてのセルを含める場合は、SetRange を使用して隠された 2 月のカテゴリを含む完全な範囲を復元します。フラグを変更するだけでは、このサンプルのキャッシュされたチャート データやカテゴリ ラベルはリフレッシュされません。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("hidden-source-data.pptx");
var slide = presentation.Slides[0];

if (slide.Shapes[0] is IChart chart)
{
    var workbook = chart.ChartData.ChartDataWorkbook;
    Console.WriteLine($"B2 hidden: {workbook.GetCell(0, "B2").IsHidden}");
    Console.WriteLine($"B3 hidden: {workbook.GetCell(0, "B3").IsHidden}");
    Console.WriteLine($"C2 hidden: {workbook.GetCell(0, "C2").IsHidden}");

    using var workbookStream = chart.ChartData.ReadWorkbookStream();
    foreach (var visibleOnly in new[] { true, false })
    {
        chart.PlotVisibleCellsOnly = visibleOnly;

        // 埋め込みワークブックからチャート データをリフレッシュします。
        workbookStream.Position = 0;
        chart.ChartData.WriteWorkbookStream(workbookStream);
        if (!visibleOnly)
        {
            // 非表示のカテゴリも含めて、完全なソース範囲を復元します。
            chart.ChartData.SetRange("Sheet1!$A$1:$C$4");
        }

        presentation.Save($"hidden_cells_{visibleOnly}.pptx", SaveFormat.Pptx);
    }
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

この例では、プレゼンテーションを 2 つのバージョンで保存します: 表示されている小売値 (10 と 20) のみを含むものと、すべての 6 値を含むものです。以下の画像は、再度開いた保存済みプレゼンテーションからレンダリングしたもので、どちらのファイルも設定されたプロット設定を保持しています。行 3 と列 C は両方の埋め込みワークブックで非表示のままです。

表示セルのみ (true) 全セル (false)
表示セルのみ: 1月と3月の小売値 10 と 20. 全セル: 1月、2月、3月の小売と卸売の値.

値を含む非表示セルは空のセルとは異なります。IChart.DisplayBlanksAs は欠損値の表示方法を制御しますが、非表示のソース データの含める・除外は行いません。例については、空のセルの表示制御 を参照してください。

チャートのデータ範囲を取得する

既存のプレゼンテーションでワークブック データを更新する前に、ソース範囲を確認し、各チャートが使用しているワークシート セルを特定します。IChartData.GetRange メソッドは、Sheet1!$A$1:$D$5 のようなワークシート限定の数式として現在のデータ範囲を返します。ここで、Sheet1 はワークシート名、! はセル範囲と区切り、$A$1:$D$5 は A1 から D5 まで(両端含む)を示します。ドル記号は絶対行・列参照を示します。

このメソッドはチャートやワークブックを変更せずに現在の範囲を読み取ります。チャートがデータ ソースとしてワークブックを使用していない場合、InvalidOperationException がスローされます。詳細は ChartData API Reference を参照してください。

この例ではプレゼンテーションを開き、各スライド上の図形を直接チェックしてチャートかどうかを判定します。各チャートの名前とソース範囲を出力します。チャートがワークブックを使用していない場合はメッセージを出力し、次のチャートへ進みます。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation("presentation.pptx");

foreach (var slide in presentation.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IChart chart)
        {
            try
            {
                var range = chart.ChartData.GetRange();
                Console.WriteLine($"{chart.Name}: {range}");
            }
            catch (InvalidOperationException)
            {
                Console.WriteLine($"{chart.Name}: The chart does not use a workbook as its data source.");
            }
        }
    }
}

ワークブックからチャート データを読み書きする

Aspose.Slides for .NET は、ReadWorkbookStream および WriteWorkbookStream メソッドを提供し、チャート データ ワークブック(Aspose.Cells で編集されたデータを含む)の読み取りと書き込みが可能です。Note: チャート データは同様の方式で構成するか、ソースに似た構造である必要があります。

この例では、最初のスライドの最初の図形としてチャートがあるプレゼンテーションを使用します。埋め込みワークブックをストリームに読み取り、既存のシリーズとカテゴリをクリアし、同じワークブックを書き戻します。変更はメモリ内に保持され、プレゼンテーションは保存されません。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation("chart.pptx");
var slide = presentation.Slides[0];

var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
    var chartData = chart.ChartData;
    using var workbookStream = chartData.ReadWorkbookStream();

    chartData.Series.Clear();
    chartData.Categories.Clear();

    workbookStream.Position = 0;
    chartData.WriteWorkbookStream(workbookStream);
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

ワークブック変更後のチャート レイアウト検証

埋め込みワークブックを変更版に置き換えると、チャートは元のシリーズおよびカテゴリ コレクションを保持します。この不一致により、IChart.ValidateChartLayout がインデックス範囲外エラーで失敗することがあります。更新されたワークブックを書き戻す前に、既存のシリーズとカテゴリをクリアしてください。この例では、最初のスライドの最初の図形としてのチャートを使用します。コメントはワークブック編集が行われる箇所を示しています。実行可能なサンプルは元のワークブックを書き戻し、メモリ内でレイアウトを検証します。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation("chart.pptx");
var slide = presentation.Slides[0];

var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
    var chartData = chart.ChartData;
    using var workbookStream = chartData.ReadWorkbookStream();

    // ここでワークブック ストリームを変更します。例として Aspose.Cells を使用します。

    chartData.Series.Clear();
    chartData.Categories.Clear();

    workbookStream.Position = 0;
    chartData.WriteWorkbookStream(workbookStream);
    chart.ValidateChartLayout();
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

コレクションをクリアすると、ワークブックを書き戻す前に古いデータ参照が削除されます。チャートを使用する前に、更新されたワークブック用に必要なシリーズやカテゴリのマッピングを再構築してください。

ワークブックセルのカスタム数値書式を設定する

ChartDataCell.CustomNumberFormat を使用して、チャートの埋め込みワークブック内で数値が表示される形式を制御します。例えば、レポートで変換率を小数点以下 4 桁のパーセンテージで、係数を小数点以下 5 桁で表示する必要がある場合があります。両方の値は数値のままにして、計算やチャートのプロットで使用できるようにします。

数値書式は表示を変更するだけで、保存された値は変わりません。書式 0.0000% は 0.125 を 12.5000% と表示しますが、保存された数値を 12.5 に置き換えるわけではありません。同様に、0.00000 は 0.1234567 を 0.12346 と表示し、保存値は丸められません。カスタム書式が空文字列 ("") の場合、PresetNumberFormat が代わりに使用されます。

以下の例では、縦棒グラフを作成し、ChartDataWorkbook を介してセルにアクセスします。ワークシート 0 では、B2 に変換率、C2 に係数が格納されています。両方のセルがチャート値を提供します。また、値ラベルをソース書式にリンクするよう有効化しています。

using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation();
presentation.SlideSize.SetSize(720, 270, SlideSizeScaleType.DoNotScale);
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 20, 620, 210);
chart.HasTitle = false;

chart.Axes.VerticalAxis.IsNumberFormatLinkedToSource = false;
chart.Axes.VerticalAxis.NumberFormat = "0.00";
chart.Axes.VerticalAxis.IsAutomaticMinValue = false;
chart.Axes.VerticalAxis.MinValue = 0;

chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();

var workbook = chart.ChartData.ChartDataWorkbook;
workbook.Clear(0);

var categoryCell = workbook.GetCell(0, "A2", "Sample");
chart.ChartData.Categories.Add(categoryCell);

var percentageCell = workbook.GetCell(0, "B2", 0.125);
percentageCell.CustomNumberFormat = "0.0000%";
var percentageName = workbook.GetCell(0, "B1", "Conversion rate");
var percentageSeries = chart.ChartData.Series.Add(percentageName, chart.Type);
percentageSeries.DataPoints.AddDataPointForBarSeries(percentageCell);

var precisionCell = workbook.GetCell(0, "C2", 0.1234567);
precisionCell.CustomNumberFormat = "0.00000";
var precisionName = workbook.GetCell(0, "C1", "Coefficient");
var precisionSeries = chart.ChartData.Series.Add(precisionName, chart.Type);
precisionSeries.DataPoints.AddDataPointForBarSeries(precisionCell);

foreach (var series in chart.ChartData.Series)
{
    var labelFormat = series.DataPoints[0].Label.DataLabelFormat;
    labelFormat.ShowValue = true;
    labelFormat.IsNumberFormatLinkedToSource = true;
}

presentation.Save("CustomCellFormats.pptx", SaveFormat.Pptx);

ワークブックセルの書式は、チャートの軸やデータ ラベルに直接設定された書式とは別です。この例では、ShowValue が有効で、各ラベルはソースセルの値を表示し、IsNumberFormatLinkedToSource が true のためソースの数値書式に従います。プレゼンテーションを保存して再度開くと、ラベルは下図のように 12.5000% と 0.12346 を表示します。縦軸は独自の NumberFormat 0.00 を使用し、IsNumberFormatLinkedToSource は false に設定されています。

データ ラベルを個別に書式設定するには、ソースリンクフラグを false にし、NumberFormat を割り当てます。これによりワークブックセルの書式は変更されません。例えば、独立したラベル書式 0.00 は最初の値を 0.13 と表示し、B2 は依然として 12.5000% を表示します。直接ラベルを書式設定する方法については、Chart Data Labels を参照してください。

以下の画像は、保存されたプレゼンテーションを再度開いた後にレンダリングしたものです。

ソースリンクラベルが 12.5000% と 0.12346 を示し、独立書式の数値軸を持つ縦棒グラフ.

ワークブック セルをチャート データ ラベルとして設定する

ワークブック セルのテキストをチャート データ ラベルとして使用できます。

この例では、既存のプレゼンテーションの最初のスライドにデフォルト データのバブル グラフを追加します。ワークシート 0 のセル A10:A12 を最初のシリーズの最初の 3 ラベルとして使用し、セルからのラベルを有効にして、更新されたプレゼンテーションを保存します。

using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("chart2.pptx");
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.Bubble, 50, 50, 600, 400, true);
var series = chart.ChartData.Series[0];
var workbook = chart.ChartData.ChartDataWorkbook;

series.Labels.DefaultDataLabelFormat.ShowLabelValueFromCell = true;
series.Labels[0].ValueFromCell = workbook.GetCell(0, "A10", "Label 0 cell value");
series.Labels[1].ValueFromCell = workbook.GetCell(0, "A11", "Label 1 cell value");
series.Labels[2].ValueFromCell = workbook.GetCell(0, "A12", "Label 2 cell value");

presentation.Save("resultchart.pptx", SaveFormat.Pptx);

ワークシートの管理

IChartDataWorkbook.Worksheets プロパティは、チャート ワークブック内のワークシートへのアクセスを提供します。この例では、デフォルト データの円グラフを作成し、各ワークシート名をコンソールに出力します。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.Pie, 50, 50, 400, 500);
var workbook = chart.ChartData.ChartDataWorkbook;

for (var i = 0; i < workbook.Worksheets.Count; i++)
{
    Console.WriteLine(workbook.Worksheets[i].Name);
}

データ ソース タイプの指定

シリーズ ポイントの値は、数値リテラルとして直接保存することもできます。保存および読み取りの完全な例については、Set Series Values Using Numeric Literals を参照してください。ポイント値のソース タイプは、チャートの内部または外部ワークブック構成とは別であり、数値リテラルを使用しても埋め込みワークブックは自動的には削除されません。

この例では、デフォルト データの 3D 縦棒グラフを作成し、異なるデータ ソースを使用して 2 つのシリーズ名を設定します。最初の名前は文字列リテラル、2 番目はワークシート 0 のセル C1 を使用します。DataSourceType 列挙体で各名前のソースを選択します。例は、更新されたシリーズ名でプレゼンテーションを保存します。

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.Column3D, 50, 50, 600, 400, true);
var literalName = chart.ChartData.Series[0].Name;

literalName.DataSourceType = DataSourceType.StringLiterals;
literalName.Data = "LiteralString";

var cellName = chart.ChartData.Series[1].Name;
var nameCell = chart.ChartData.ChartDataWorkbook.GetCell(0, "C1", "NewCell");
cellName.DataSourceType = DataSourceType.Worksheet;
cellName.Data = nameCell;

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

サポートされていない埋め込みワークブック形式の検出

Aspose.Slides は、一部のチャートに埋め込める Excel バイナリ ワークブック (.xlsb) 形式をサポートしていません。IChartData の EmbeddedWorkbookType プロパティと WorkbookType 列挙体を組み合わせて、サポートされない形式を検出し、該当チャートをスキップできます。この例では、既存プレゼンテーションの最初のスライドの図形を調べ、チャートでない図形をスキップし、埋め込み .xlsb ワークブックを持つ各チャートに診断メッセージを出力します。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation("sample.pptx");
var slide = presentation.Slides[0];

foreach (var shape in slide.Shapes)
{
    if (shape is not IChart chart)
    {
        continue;
    }

    var chartData = chart.ChartData;
    var isInternalWorkbook = chartData.DataSourceType == ChartDataSourceType.InternalWorkbook;
    var isBinaryMacro = chartData.EmbeddedWorkbookType == WorkbookType.WorkbookBinaryMacro;

    if (isInternalWorkbook && isBinaryMacro)
    {
        Console.WriteLine("Skipping a chart with an unsupported .xlsb workbook.");
        continue;
    }

    // ここでサポートされているチャート ワークブック データを読み取ったり、変更したりします。
}

外部ワークブック

Aspose.Slides は、外部ワークブックをチャートのデータ ソースとして使用することをサポートしています。

外部ワークブックの作成

ReadWorkbookStream と SetExternalWorkbook を使用して、埋め込みチャート ワークブックをファイルにエクスポートし、チャートをその外部ワークブックにリンクします。

この例では、デフォルト データの円グラフを作成し、そのワークブックをエクスポートします。外部ワークブックをチャート データ ソースとして割り当てる前に出力ストリームを閉じ、リンクされたプレゼンテーションを保存します。

using System.IO;
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.Pie, 50, 50, 400, 600);
var workbookPath = Path.GetFullPath("externalWorkbook1.xlsx");

using (var workbookStream = chart.ChartData.ReadWorkbookStream())
using (var fileStream = File.Create(workbookPath))
{
    workbookStream.CopyTo(fileStream);
}

chart.ChartData.SetExternalWorkbook(workbookPath);
presentation.Save("externalWorkbook.pptx", SaveFormat.Pptx);

外部ワークブックの設定

SetExternalWorkbook メソッドを使用して、外部ワークブックをチャートのデータ ソースとして割り当てることができます。このメソッドは、外部ワークブックのパスを更新する場合(移動された場合)にも使用できます。

リモート場所やリソースに保存されたワークブックのデータは編集できませんが、外部データ ソースとして使用することは可能です。外部ワークブックの相対パスが指定されると、自動的に完全パスに変換されます。

この例では、Sheet1 という名前のワークシートに B1 にシリーズ名、A2:A4 にカテゴリ名、B2:B4 に数値が含まれる外部ワークブックを使用します。例は円グラフを作成し、ワークブックをリンクし、SetRange を使用して A1:B4 を 1 つのシリーズと 3 つのカテゴリにマップします。リンクされたチャートを含むプレゼンテーションを保存します。

using System.IO;
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.Pie, 50, 50, 400, 600, true);
var chartData = chart.ChartData;
var workbookPath = Path.GetFullPath("externalWorkbook.xlsx");

chartData.SetExternalWorkbook(workbookPath);
chartData.SetRange("Sheet1!$A$1:$B$4");

presentation.Save("Presentation_with_externalWorkbook.pptx", SaveFormat.Pptx);

SetExternalWorkbook の updateChartData パラメーターは、ワークブックをロードするかどうかを制御します。

  • updateChartData が false の場合、ワークブック パスのみが更新されます。チャート データはターゲット ワークブックからロードまたは更新されないため、ワークブックは利用できなくても構いません。
  • updateChartData が true の場合、チャート データはターゲット ワークブックから更新されます。

次の例では、updateChartData を false に設定したプレースホルダー URL を割り当てます。円グラフのデフォルト データを保持し、利用できないワークブックをロードせずにプレゼンテーションを保存します。

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.Pie, 50, 50, 400, 600, true);

chart.ChartData.SetExternalWorkbook("https://example.com/unavailable-workbook.xlsx", false);
presentation.Save("SetExternalWorkbookWithUpdateChartData.pptx", SaveFormat.Pptx);

チャートの外部データ ソース ワークブック パスの取得

チャートにリンクされたワークブックを特定するには、チャートが外部データ ソースを使用しているか確認し、ワークブック パスを取得します。

この例では、外部ワークブックがリンクされたプレゼンテーションの最初のスライドの最初の図形を調べます。外部ワークブックにリンクされたチャートであれば、ExternalWorkbookPath をコンソールに出力します。その後、プレゼンテーションのコピーを保存します。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("externalWorkbook.pptx");
var slide = presentation.Slides[0];

var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
    var chartData = chart.ChartData;
    if (chartData.DataSourceType == ChartDataSourceType.ExternalWorkbook)
    {
        Console.WriteLine(chartData.ExternalWorkbookPath);
    }
    else
    {
        Console.WriteLine("The chart does not use an external workbook.");
    }
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

presentation.Save("Result.pptx", SaveFormat.Pptx);

チャート データの編集

外部ワークブックのデータは、内部ワークブックの内容を変更するのと同様に編集できます。外部ワークブックがロードできない場合、例外がスローされます。

この例では、最初のスライドの最初の図形としてのチャートを使用し、アクセス可能な外部ワークブックにリンクしています。最初のシリーズの最初のデータ ポイントのセル参照値を 100 に設定し、更新されたプレゼンテーションを保存します。セル値を編集するとリンクされた外部 XLSX ファイルが更新されるため、元のワークブックを保持したい場合はコピーを使用してください。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("presentation.pptx");
var slide = presentation.Slides[0];

var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
    var series = chart.ChartData.Series;
    if (series.Count > 0 && series[0].DataPoints.Count > 0)
    {
        var valueCell = series[0].DataPoints[0].Value.AsCell;
        if (valueCell != null)
        {
            valueCell.Value = 100;
            presentation.Save("presentation_out.pptx", SaveFormat.Pptx);
        }
        else
        {
            Console.WriteLine("The first data point is not linked to a workbook cell.");
        }
    }
    else
    {
        Console.WriteLine("The chart has no data points to edit.");
    }
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

ソース ワークブックからチャート データをリフレッシュする

Aspose.Slides for .NET 26.11 では、1 つのチャートに対する IChartData.RefreshData と、プレゼンテーション全体に対する IPresentation.RefreshChartsData が追加されました。ソース ワークブックの値が変更された後に使用します。外部ワークブックはアクセス可能でサポートされている必要があります。

Aspose.Slides for .NET 26.11 以降がインストールされている場合、この例は charts.pptx の最初のスライドの最初のチャートをリフレッシュします。ソース ワークブックが利用可能である必要があります。結果を保存して更新されたチャート データを保持します。

using System;
using System.Linq;
using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("charts.pptx");
var chart = presentation.Slides[0].Shapes.OfType<IChart>().FirstOrDefault();
if (chart == null)
{
    Console.WriteLine("The first slide must contain a chart.");
    return;
}

chart.ChartData.RefreshData();
presentation.Save("refreshed-chart.pptx", SaveFormat.Pptx);

すべてのチャートをリフレッシュするには、別のプレゼンテーション インスタンスを使用します。false を渡すと、リフレッシュ失敗が呼び出し元に伝搬し、既にリフレッシュされたチャートはロールバックされません。

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("charts.pptx");
presentation.RefreshChartsData(skipFailedCharts: false);
presentation.Save("refreshed-charts.pptx", SaveFormat.Pptx);

パラメーターのデフォルトは true です: RefreshChartsData は失敗したチャートをスキップして他のチャートを続行します。チャートごとの結果は返さないため、完了した呼び出しがすべてのチャートがリフレッシュされたことを証明するわけではありません。失敗した各チャートを特定する必要がある場合は、個別の RefreshData 呼び出しを使用してください。

リフレッシュはソース データを再読み込みします。これは数式計算やチャート レイアウトの検証、OLE プレビューの更新とは別です。メモリ内でリフレッシュを確認するには、ライブのセル参照値を検査します。CachedValue は、プレゼンテーションを保存して再度開くまで、以前に保存されたチャートを表すことができます。

ワークブックなしでキャッシュされたチャート値を読み取る

.NET 26.11 では、キャッシュ値アクセサーはワークブックを開かずにチャートに保存された値を読み取ります。リンクされたファイルが利用できず、チャートの最後に保存されたデータだけが必要な場合に便利です。これは、以下のリカバリ オプションでワークブックを再構築する場合とは異なります。

オブジェクト キャッシュアクセサー
通常のシリーズ データ ポイント CachedValue
散布図またはバブル データ ポイント CachedXValue, CachedYValue
バブル データ ポイント CachedBubbleSize
チャート カテゴリ CachedValue

各アクセサーは ICachedChartValue を返します。Data は保存されたオブジェクトを公開し、ToString はテキストを提供し、ToDouble は欠損または数値でない値の場合に NaN を返します。キャッシュは存在しないか古くなることがあり、保存されていない新規作成チャートでも同様です。すべてのフィールドが存在し、数値を含むとは限らないことを前提にしないでください。

この例では、チャートを含む保存済みプレゼンテーション cached-chart.pptx からそれらすべてのフィールドを読み取ります。外部ワークブックが欠損していても問題ありません。コードは ChartDataWorkbook やライブワークブックセルにアクセスしないためです。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

using var presentation = new Presentation("cached-chart.pptx");
foreach (var slide in presentation.Slides)
foreach (var shape in slide.Shapes)
{
    if (shape is not IChart chart)
        continue;

    foreach (var category in chart.ChartData.Categories)
        PrintCache("Category", category.CachedValue);

    foreach (var series in chart.ChartData.Series)
    foreach (var point in series.DataPoints)
    {
        PrintCache("Value", point.CachedValue);
        PrintCache("X", point.CachedXValue);
        PrintCache("Y", point.CachedYValue);
        PrintCache("Bubble size", point.CachedBubbleSize);
    }
}

static void PrintCache(string name, ICachedChartValue value)
{
    var number = value.ToDouble();
    if (value.Data == null)
        Console.WriteLine($"{name}: no cached value");
    else if (double.IsNaN(number))
        Console.WriteLine($"{name}: {value} (not numeric)");
    else
        Console.WriteLine($"{name}: {number}");
}

現在のソース データが必要な場合はリフレッシュを使用し、保存されたスナップショットで十分な場合はキャッシュ読み取りを使用してください。キャッシュはワークブックの完全なコピーではなく、最後に更新された後の変更を提供できません。

チャート キャッシュからワークブックを復元する

チャートが欠損または利用できない外部ワークブックを使用している場合、Aspose.Slides はプレゼンテーションにキャッシュされているデータからチャート ワークブックを再構築できます。プレゼンテーションを開く前に、LoadOptions を作成し、SpreadsheetOptions を設定し、ISpreadsheetOptions.RecoverWorkbookFromChartCache を true に設定します。

以下の C# 例は、最初のスライドの最初の図形で、利用できない外部ワークブックを参照しているチャートのワークブック データを復元します。復元されたデータは IChart.ChartData と IChartData.ChartDataWorkbook を介してアクセスします。

using System;
using Aspose.Slides;
using Aspose.Slides.Charts;

var spreadsheetOptions = new SpreadsheetOptions
{
    RecoverWorkbookFromChartCache = true
};
var loadOptions = new LoadOptions
{
    SpreadsheetOptions = spreadsheetOptions
};

using var presentation = new Presentation("presentation.pptx", loadOptions);
var slide = presentation.Slides[0];

var shapeCount = slide.Shapes.Count;
if (shapeCount > 0 && slide.Shapes[0] is IChart chart)
{
    var recoveredWorkbook = chart.ChartData.ChartDataWorkbook;

    // ここで復元されたワークブック データを読み取るか、変更してください。
}
else
{
    Console.WriteLine("The first shape is not a chart.");
}

コードが外部ワークブックにアクセスし、それが利用できずリカバリが無効な場合、Aspose.Slides は InvalidOperationException をスローします。キャッシュされたチャート データの使用が許容できるフォールバックである場合にのみリカバリを有効にしてください。キャッシュにはプレゼンテーションが最後に更新された後の外部ワークブックの変更が含まれない可能性があります。

FAQ

特定のチャートが外部ワークブックにリンクされているか、埋め込みワークブックかを判別できますか?

はい。チャートには data source type と path to an external workbook があり、ソースが外部ワークブックである場合はフルパスを読み取ることで外部ファイルが使用されていることを確認できます。

外部ワークブックへの相対パスはサポートされていますか? それらはどのように保存されますか?

はい。相対パスを指定すると、自動的に絶対パスに変換されます。プレゼンテーションは PPTX ファイル内に絶対パスを保存するため、ワークブックを移動した場合はリンクの更新が必要になることがあります。

ネットワークリソース/共有にあるワークブックを使用できますか?

はい、そのようなワークブックは外部データ ソースとして使用できます。ただし、Aspose.Slides からリモートワークブックを直接編集することはサポートされておらず、ソースとしてのみ使用できます。

プレゼンテーションを保存すると、Aspose.Slides は外部 XLSX を上書きしますか?

プレゼンテーションは link to the external file を保存します。セル参照のチャート データを編集すると、リンクされたローカル XLSX ファイルも更新されることがあります。元のファイルを変更しないようにするには、ワークブックのコピーを使用してください。

外部ファイルがパスワードで保護されている場合、どうすればよいですか?

Aspose.Slides はリンク時にパスワードを受け付けません。一般的な対策は、事前に保護を解除するか、復号化したコピー(例: Aspose.Cells を使用)を用意し、そのコピーにリンクすることです。

複数のチャートが同じ外部ワークブックを参照できますか?

はい。各チャートは個別のリンクを保持します。すべてが同じファイルを指している場合、そのファイルを更新すると、次回データをロードした際に各チャートに反映されます。