Documentation – ピボットテーブルを挿入する

Net: ピボットテーブルの書式設定

Mon, 01 Jan 0001 00:00:00 +0000

ピボットテーブルの外観

ピボットテーブルの外観をカスタマイズする方法については、「ピボットテーブルの作成」でシンプルなピボットテーブルの作成方法が説明されています。この記事では、さまざまなプロパティを設定してピボットテーブルの外観をカスタマイズする方法について説明します:

ピボットテーブルの書式オプション
ピボットフィールドの書式オプション
データフィールドの書式オプション

ピボットテーブルの書式オプションの設定

PivotTable クラスは、全体のピボットテーブルを制御し、さまざまな方法で書式設定できます。

AutoFormat タイプの設定

Microsoft Excel はさまざまなプリセットレポート形式を提供しています。Aspose.Cells もこれらの書式オプションをサポートしています。これらにアクセスするには:

PivotTable.IsAutoFormat を true に設定します。
PivotTableAutoFormatType 列挙型から書式設定オプションを割り当てます。

書式オプションの設定

以下のコードサンプルは、ピボットテーブルを書式設定して行と列の合計を表示する方法、およびレポートのフィールド順序を設定する方法を示しています。また、null 値にカスタム文字列を設定する方法も示しています。

見た目と手触りの書式設定

事前設定されたレポート形式を使用せずに、ピボットテーブルレポートの見た目を手動で書式設定するには、PivotTable.Format() と PivotTable.FormatAll() メソッドを使用します。必要な書式設定のスタイルオブジェクトを作成します。たとえば:

ピボットフィールドの書式オプションの設定

PivotField クラスは、ピボットテーブルのフィールドを表し、さまざまな方法で書式設定できます。以下のコードサンプルは、次のように行います:

行フィールドへのアクセス。
小計の設定。
自動並べ替えの設定。
自動表示の設定。

行/列/ページフィールドの書式の設定

データフィールドの書式の設定

以下のコードサンプルは、データフィールドの表示形式と数値形式を設定する方法を示しています。

ピボットフィールドのクリア

PivotFieldCollection には、ピボットフィールドをクリアするための Clear() メソッドがあります。たとえば、ページ、列、行、またはデータなど、領域内のすべてのピボットフィールドをクリアしたい場合に使用します。以下のコードサンプルは、データ領域内のすべてのピボットフィールドをクリアする方法を示しています。

Net: ピボットテーブルとピボットチャートの作成

Mon, 01 Jan 0001 00:00:00 +0000

ピボットテーブルは、レコードのインタラクティブな集計です。たとえば、ワークシートのリストには数百の請求書エントリがあります。ピボットテーブルは、顧客、製品、または日付別に請求書を合計することができます。Microsoft Excelを使用すると、ピボットテーブル内の情報をボタンをドラッグするだけで素早く再配置することが可能です。

ピボットチャートは、ピボットテーブルのデータのインタラクティブなグラフィカルな表現です。ピボットチャートはExcel 2000で導入されました。ピボットテーブルが自動的に小計と合計を作成するため、ピボットチャートを使用することでデータを理解することがさらに容易になります。

Aspose.Cellsはpivot tablesとpivot chartsをサポートしています。

ピボットテーブルとチャートの追加

Aspose.Cellsは、ピボットテーブルを作成するために使用される特別なクラスセットを提供しています。これらのクラスは、PivotTableオブジェクトを作成し、設定するために使用されます。これらのオブジェクトはPivotTableオブジェクトの基本的な構成要素として機能します:

PivotField、ピボットテーブルレポート内のフィールド。
PivotFields、ピボットテーブル内のすべてのPivotFieldオブジェクトのコレクション。
PivotTable、ワークシート上のPivotTableレポート。
PivotTables、ワークシート上のすべてのPivotTableオブジェクトのコレクション。

Aspose.Cellsの使用準備

Aspose.Cellsをダウンロードしてインストールします。
1. Aspose.Cellsをダウンロードします。
2. 開発コンピュータにインストールします。すべてのAsposeコンポーネントはインストールされると評価モードで動作します。評価モードには時間制限はなく、生成されたドキュメントにウォーターマークが注入されるのみです。コンポーネントをフル機能で使用するには、有効なライセンスが必要です。
プロジェクトを作成します。
1. Visual Studio.Net を起動します。
2. 新しいコンソールアプリケーションを作成します。
参照を追加します。 Aspose.Cellsコンポーネントをプロジェクトに参照として追加します。たとえば…\Program Files\Aspose\Aspose.Cells\Bin\Net1.0\Aspose.Cells.dll

ピボットテーブルの追加

Aspose.Cellsを使用してピボットテーブルを作成するには:

CellオブジェクトのPutValue/setValueメソッドを使用してワークシートセルにデータを追加します。また、データがすでに入力されたテンプレートファイルを使用することもできます。これらのデータはピボットテーブルのデータソースとして使用されます。
PivotTablesコレクションのaddメソッド（Worksheetオブジェクトにカプセル化されています）を呼び出すことによって、ワークシートにピボットテーブルを追加します。
ピボットテーブルの新しいPivotTableオブジェクトにアクセスするには、そのインデックスを渡してPivotTablesコレクションからアクセスします。#PivotTableオブジェクトにカプセル化されているピボットテーブルオブジェクトを使用して、テーブルを管理します。

以下にコード例を示します。

ピボットチャートの追加

Aspose.Cellsを使用してPivotChartを作成するには:

チャートを追加します。
グラフのPivotSourceを、スプレッドシート内の既存のピボットテーブルを指すように設定します。
他の属性を設定します。

Net: ピボットテーブルとソースデータ

Mon, 01 Jan 0001 00:00:00 +0000

Pivot Tableのソースデータ

デザイン時にはわからない異なるデータソース（たとえばデータベースなど）からデータを取るピボットテーブルを作成したいときがあります。この記事では、ピボットテーブルのデータソースを動的に変更するアプローチについて説明します。

ピボットテーブルのデータソースを変更する

新しいデザイナーテンプレートを作成します。
1. 以下のスクリーンショットに示すように、新しいデザイナーテンプレートファイルを作成します。
2. その後、DataSourceという名前の範囲を定義します。この範囲はこれらのセルの範囲を参照します。
  
  デザイナーテンプレートの作成と名前付き範囲の定義、DataSource

この名前付き範囲に基づいてPivot Tableを作成します。
1. Microsoft Excelでデータ、ピボットテーブル、ピボットテーブルおよびピボットチャートレポートを選択します。
2. 最初のステップで作成した名前付き範囲に基づいてピボットテーブルを作成します。
  
  DataSourceに基づいてピボットテーブルを作成する

対応するフィールドをピボットテーブルの行と列にドラッグし、スクリーンショットに示されているような結果のピボットテーブルを作成します。

対応するフィールドに基づいてピボットテーブルを作成する

設計したピボットテーブルが以下に示されています。

データオプションの設定で開くときに更新をチェックします。

ピボットテーブルオプションの設定

これで、このファイルをデザイナーテンプレートファイルとして保存できます。

新しいデータを埋め込んでピボットテーブルのソースデータを変更します。
1. デザイナーテンプレートが作成されたら、次のコードを使用してピボットテーブルのソースデータを変更します。

以下のコード例を実行すると、ピボットテーブルのソースデータが変更されます。

Net: ピボットテーブルに計算フィールドを追加する

Mon, 01 Jan 0001 00:00:00 +0000

可能な使用シナリオ

既知のデータに基づいてピボットテーブルを作成すると、それに含まれるデータが望んでいるものではないことがあります。望んでいるデータは、これらの元のデータの組み合わせです。たとえば、データを望んだ形式にするために、元のデータを加算、減算、乗算、除算する必要があります。その場合、計算フィールドを構築し、計算用の対応する式を設定する必要があります。その後、計算フィールドで統計などの操作を行います。

Excelのピボットテーブルに計算フィールドを追加

Excelのピボットテーブルに計算フィールドを挿入するには、以下の手順に従います:

追加したいピボットテーブルを選択します。
リボットテーブルツールの「分析」タブに移動します。
「フィールド、アイテム、およびセット」をクリックし、その後、ドロップダウンメニューから「計算フィールド」を選択します。
「名前」フィールドに、計算フィールドの名前を入力します。
「式」フィールドに、適切なピボットテーブルのフィールド名と数学演算子を使用して実行する計算の式を入力します。
「OK」をクリックして計算フィールドを作成します。
新しい計算フィールドは、値のセクションの下にあるピボットテーブルフィールドリストに表示されます。
計算フィールドをピボットテーブルの値セクションにドラッグして、計算された値を表示します。

C#を使用してピボットテーブルに計算フィールドを追加

Aspose.Cellsを使用してExcelファイルに計算フィールドを追加します。次のサンプルコードを実行すると、ワークシートに計算フィールドを追加したピボットテーブルが追加されます。

元のデータを設定し、ピボットテーブルを作成します。
ピボットテーブル内の既存のPivotFieldに応じて計算フィールドを作成します。
計算フィールドをデータ領域に追加します。
最後に、output XLSX形式でブックを保存します。

サンプルコード

Net: Aspose.Cells for .NET でピボットテーブルにスタイルを適用する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cellsは、レガシーピボット自動書式（.xlsファイル向け）と、モダンな名前付きまたはカスタムピボットテーブルスタイル（.xlsx、.xlsm、.xlsbファイル向け）の両方の適用をサポートしています。使用すべきAPIは、ワークブックを読み込んだ形式ではなく、保存先のファイル形式によって決まります。

はじめに

Aspose.Cellsはピボットテーブル用に2つの並列スタイルAPIを公開しています。これらの選択は、ワークブックの読み込み元ではなく、保存先のファイル形式によって決まります。.xlsファイルから読み込まれたワークブックを.xlsxとして再保存することができ、その場合はレガシーAPIではなくモダンスタイルAPIが適用されます。

レガシー.xls出力の場合は、PivotTable.AutoFormatTypeプロパティをAspose.Cells.Pivot.PivotTableAutoFormatType列挙型と一緒に使用してください。このAPIは、クラシックExcelでピボットテーブル用に提供されていた自動書式ピッカーに対応しています。

モダン.xlsx、.xlsm、.xlsb出力の場合は、2種類のスタイルAPIを利用できます。

PivotTable.PivotTableStyleTypeは、組み込みの名前付きスタイル（Excel 2017で追加されたスタイルを含むライトテーマおよびダークテーマ）の中から1つを選択します。これらのプリセットは読み取り専用です。
PivotTable.PivotTableStyleNameは、Workbook.Worksheets.TableStyles.AddPivotTableStyle(...)で定義したカスタムスタイルを選択します。プリセットで提供される色、罫線、フォントを超えて変更を加えたい場合は、必ずカスタムスタイルが必要になります。

さらに、PivotTable.FormatAll(Style)は、単一のStyleオブジェクトをピボットのすべてのセルに適用するショートカットで、上記のスタイル名APIで設定された内容をすべて上書きします。これは、基になるテーマに関係なく均一な外観が必要な場合に便利です。

レガシーXLSプリセット自動書式の適用

PivotTable.AutoFormatTypeは、Aspose.Cells.Pivot.PivotTableAutoFormatType列挙型の値を受け取ります。利用可能な値はReport1からReport10、Classic、およびTable1からTable10です。

AutoFormatTypeは、ワークブックが.xlsとして保存される場合にのみ有効です。同じワークブックが.xlsx、.xlsm、または.xlsbとして保存された場合、Excelはこのプロパティを無視し、PivotTableStyleTypeおよびPivotTableStyleNameの設定にフォールバックします。

次の例では、新しいワークブックを読み込み、Fruit/Year/Amountサンプルデータを設定し、ピボットテーブルを追加してPivotTableAutoFormatType.Report5を適用し、結果を.xlsとして保存します。

列フィールドがないのはなぜですか？ Report シリーズの自動書式（Report1〜Report10、Table1〜Table10）は、従来の Excel で単一次元のピボットテーブル（行フィールドと値のみ）のために設計されたものであり、列フィールドのヘッダーに対する組み込みのスタイル設定はありません。ピボットテーブルに列フィールドが必要な場合は、代わりに下のシナリオ 2 のモダンな PivotTableStyleType プリセットを使用してください。これらはモダンな Excel が使用する二次元レイアウト向けに設計されています。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// シナリオ1: レガシー XLS プリセット自動書式を適用する
// 使用する API: PivotTable.AutoFormatType
// ターゲットファイル形式: .xls (レガシー)
// 完全なサンプルとデータファイルについては、https://github.com/aspose-cells/Aspose.Cells-for-.NET を参照してください

// 新しいワークブックを作成する
Workbook workbook = new Workbook();

// 最初のワークシートを取得する
Worksheet sheet = workbook.Worksheets[0];

// ヘッダー行 (Fruit, Year, Amount) を含むソースデータを入力する
// および 2020 年と 2021 年にわたる grape、blueberry、kiwi、cherry をカバーする 9 つのデータ行
sheet.Cells[0, 0].PutValue("Fruit");
sheet.Cells[0, 1].PutValue("Year");
sheet.Cells[0, 2].PutValue("Amount");

sheet.Cells[1, 0].PutValue("grape");
sheet.Cells[1, 1].PutValue(2020);
sheet.Cells[1, 2].PutValue(50);

sheet.Cells[2, 0].PutValue("blueberry");
sheet.Cells[2, 1].PutValue(2020);
sheet.Cells[2, 2].PutValue(30);

sheet.Cells[3, 0].PutValue("kiwi");
sheet.Cells[3, 1].PutValue(2020);
sheet.Cells[3, 2].PutValue(25);

sheet.Cells[4, 0].PutValue("cherry");
sheet.Cells[4, 1].PutValue(2020);
sheet.Cells[4, 2].PutValue(40);

sheet.Cells[5, 0].PutValue("grape");
sheet.Cells[5, 1].PutValue(2021);
sheet.Cells[5, 2].PutValue(60);

sheet.Cells[6, 0].PutValue("blueberry");
sheet.Cells[6, 1].PutValue(2021);
sheet.Cells[6, 2].PutValue(35);

sheet.Cells[7, 0].PutValue("kiwi");
sheet.Cells[7, 1].PutValue(2021);
sheet.Cells[7, 2].PutValue(28);

sheet.Cells[8, 0].PutValue("cherry");
sheet.Cells[8, 1].PutValue(2021);
sheet.Cells[8, 2].PutValue(45);

sheet.Cells[9, 0].PutValue("grape");
sheet.Cells[9, 1].PutValue(2020);
sheet.Cells[9, 2].PutValue(45);

// 移動先セル E3 に "Pivot1" という名前のピボットテーブルを、ソース範囲 A1:C10 を使用して追加する
int pivotIndex = sheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

// フィールドを割り当てる: Fruit -> 行、Year -> 列、Amount -> データ
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// レガシー XLS プリセット自動書式 "Report5" を適用する
// 注: このプロパティは .xls として保存する場合にのみ有効です。
// .xlsx/.xlsm/.xlsb として保存する場合、Excel は AutoFormatType を無視し、
// PivotTableStyleType / PivotTableStyleName で指定された内容を使用します。
pivotTable.AutoFormatType = PivotTableAutoFormatType.Report5;

// ワークブックをレガシー .xls 形式で保存する
workbook.Save("output.xls");

モダンな名前付きプリセットピボットテーブルスタイルの適用

PivotTable.PivotTableStyleTypeは、Aspose.Cells.PivotTableStyleType列挙型の値を受け取ります。この列挙型は、ライトテーマのPivotTableStyleLight1からPivotTableStyleLight28、およびダークテーマのPivotTableStyleDark1からPivotTableStyleDark28をカバーしています。Excel 2017で追加されたスタイル（第2波のライトおよびダークテーマ）も同じ列挙型からアクセスできます。

これは、モダンファイル形式に対して推奨されるAPIです。レガシー自動書式とは異なり、ここで選択されたスタイルはExcelによって忠実にレンダリングされ、他のOfficeツールとのラウンドトリップ後も維持されます。

次の例では、同じFruit/Year/Amountデータを使用し、同じピボットテーブルを作成してPivotTableStyleDark1を適用し、ワークブックを.xlsxとして保存します。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// シナリオ 2: PivotTableStyleType を使用してモダンな Excel 2007+ の名前付き定義済みスタイルを適用します。
// 対象ファイル形式: .xlsx。PivotTableStyleType 列挙型は Aspose.Cells 名前空間にあります
// (Aspose.Cells.Pivot ではありません) — そのため追加の using は不要です。
// GitHub リファレンス: https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// ヘッダー行: Fruit / Year / Amount
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// Fruit / Year / Amount の 9 件のデータ行
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(180);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(120);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(170);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(210);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(190);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(130);

// E3 に "Pivot1" という名前のピボットテーブルを追加し、データソースは A1:C10 とする
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// ピボットフィールドを割り当てる: Fruit -> 行エリア、Year -> 列エリア、Amount -> データエリア
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// モダンな Excel 2007+ の名前付き定義済みピボットスタイルを適用します。
// PivotTableStyleType は .xlsx / .xlsm / .xlsb ファイルに対して正しい API です。AutoFormatType は
// これらの形式では Excel によって無視されます。PivotTableStyleDark1 はダークテーマファミリー
// (PivotTableStyleDark1..PivotTableStyleDark28) に属し、同じ列挙型には新しい Excel 2017 の
// ライト/ダークテーマ (PivotTableStyleLight1..Light28 / Dark1..Dark28) も公開されています。
pivotTable.PivotTableStyleType = PivotTableStyleType.PivotTableStyleDark1;

// モダンな .xlsx として保存 — これは PivotTableStyleType が意味を持つ形式です。
workbook.Save("output.xlsx");

カスタムピボットテーブルスタイルの定義と適用

組み込みプリセットは変更できません。色、罫線、またはフォントを上書きする必要がある場合は、必ずカスタムピボットスタイルを定義する必要があります。ワークフローは3つのステップで構成されます。

Workbook.Worksheets.TableStyles.AddPivotTableStyle(string name)を使用して、ワークブックのTableStylesコレクションにカスタムスタイルを追加します。これにより、新しく作成されたスタイルのインデックスが返されます。
TableStyle.TableStyleElements.Add(TableStyleElementType)で要素（WholeTableやGrandTotalRowなど）を追加し、TableStyleElement.SetElementStyle(Style)で各要素にStyleを割り当てることで、スタイルを構成します。
PivotTable.PivotTableStyleNameにスタイル名を設定して、カスタムスタイルをピボットに適用します。このプロパティは組み込みプリセットを選択するため、ここではPivotTableStyleTypeを使用しないでください。

PivotTableStyleNameとPivotTableStyleTypeは置き換え可能ではありません。組み込みプリセットにはPivotTableStyleTypeを、AddPivotTableStyleで定義したカスタムスタイルにはPivotTableStyleNameを使用してください。両方を設定しても害はありませんが、意図したソースと一致する一方のみがレンダリングされます。

利用可能なTableStyleElementTypeの値には、WholeTable、FirstRow、LastRow、FirstColumn、LastColumn、GrandTotalRow、GrandTotalColumn、PageFieldLabels、PageFieldValuesがあります。

次の例では、WholeTableに細い黒の罫線を、GrandTotalRowに太字の赤いフォントを持つカスタムピボットスタイルを定義し、PivotTableStyleNameを介して適用して、.xlsxとして保存します。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;
using System.Drawing;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// ソースデータを設定: ヘッダー行 + 9 データ行 (A1:C10)
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(900);

// A1:C10 をソースとするピボットテーブルを E3 に配置し、"Pivot1" という名前を付ける
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// ステップ 1: 新しいカスタムピボットテーブルスタイルを登録し、そのインデックスを取得する
int styleIndex = workbook.Worksheets.TableStyles.AddPivotTableStyle("CustomPivotStyle");
TableStyle tableStyle = workbook.Worksheets.TableStyles[styleIndex];

// ステップ 2: WholeTable 要素を追加し、4 辺すべてに細い黒色の境界線を適用する
int wholeTableElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.WholeTable);
TableStyleElement wholeTableElement = tableStyle.TableStyleElements[wholeTableElementIndex];
Style wholeTableStyle = workbook.CreateStyle();
wholeTableStyle.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.TopBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.BottomBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.LeftBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.RightBorder].Color = Color.Black;
wholeTableElement.SetElementStyle(wholeTableStyle);

// ステップ 3: GrandTotalRow 要素を追加し、太字の赤色フォントを適用する
int grandTotalElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.GrandTotalRow);
TableStyleElement grandTotalElement = tableStyle.TableStyleElements[grandTotalElementIndex];
Style grandTotalStyle = workbook.CreateStyle();
grandTotalStyle.Font.IsBold = true;
grandTotalStyle.Font.Color = Color.Red;
grandTotalElement.SetElementStyle(grandTotalStyle);

// ステップ 4: カスタムスタイルを名前で適用する (組み込みプリセット用の PivotTableStyleType ではなく)
pivotTable.PivotTableStyleName = "CustomPivotStyle";

workbook.Save("output.xlsx");

FormatAll で1つのスタイルをすべてのピボットセルに適用する

PivotTable.FormatAll(Style)は、データエリア、行と列のヘッダー、集計を含むピボットテーブルのすべてのセルに単一のStyleオブジェクトを適用するショートカットです。PivotTableStyleTypeまたはPivotTableStyleNameを介して以前に設定された内容はすべて上書きされます。

FormatAllはPivotTableStyleTypeとPivotTableStyleNameの両方を上書きします。ピボット全体でテーマに関係なく均一な外観が必要な場合にのみ使用してください。

次の例では、黄色の単色塗りつぶし、太字のダークブルーフォント、すべての辺に細い黒の罫線を持つStyleを作成し、FormatAllで適用して、.xlsxとして保存します。

using System;
using System.Drawing;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// シナリオ4: FormatAllを使用して、すべてのピボットテーブルセルに単一のスタイルを適用
// 使用API: PivotTable.FormatAll(Style)
// 対象形式: .xlsx
// GitHubリファレンス: Aspose.Cells-for-.NETリポジトリを参照 — ピボットテーブルスタイリングの例

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// ソースデータを入力: ヘッダー行(1行目) + データ9行(2～10行目)
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(5000);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(3000);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(4000);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(2000);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(6000);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(3500);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(4500);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(2500);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(5500);

// ピボットテーブルを追加: ソース範囲 A1:C10、配置先セル E3、名前 "Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// ピボットフィールドを割り当て: Fruit → 行エリア、Year → 列エリア、Amount → データエリア
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// ピボットテーブルのすべてのセルに強制適用するStyleを構築
Style style = workbook.CreateStyle();
style.ForegroundColor = Color.Yellow;
style.Pattern = BackgroundType.Solid;
style.Font.IsBold = true;
style.Font.Color = Color.DarkBlue;
style.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.TopBorder].Color = Color.Black;
style.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.BottomBorder].Color = Color.Black;
style.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.LeftBorder].Color = Color.Black;
style.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.RightBorder].Color = Color.Black;

// FormatAllを適用: この単一のスタイルをピボットテーブルのすべてのセルに強制適用し、
// 以前に設定された PivotTableStyleType / PivotTableStyleName を上書きします
pivotTable.FormatAll(style);

// モダンな .xlsx 形式でワークブックを保存
workbook.Save("output.xlsx");

どのスタイルAPIを使用すべきですか?

スタイルAPIの選択は、保存先のファイル形式によって異なります。下の表をクイックリファレンスとしてご活用ください。

保存先のファイル形式	使用するAPI	備考
`.xls`（レガシー）	`PivotTable.AutoFormatType`	`Aspose.Cells.Pivot.PivotTableAutoFormatType`の値（例：`Report1`～`Report10`、`Classic`、`Table1`～`Table10`）。モダン形式で保存する場合は無視されます。
`.xlsx` / `.xlsm` / `.xlsb`（モダン、組み込みスタイル）	`PivotTable.PivotTableStyleType`	`Aspose.Cells.PivotTableStyleType`の値（Excel 2017で追加されたものを含むライト/ダークテーマ）。
`.xlsx` / `.xlsm` / `.xlsb`（モダン、カスタムスタイル）	`PivotTable.PivotTableStyleName` + `Worksheets.TableStyles.AddPivotTableStyle(...)`	組み込みプリセットでは不十分な場合に使用します。`TableStyleElement.SetElementStyle(...)`で設定します。
任意の形式（一律上書き）	`PivotTable.FormatAll(Style)`	ピボット全体の他のすべてのスタイル設定を上書きするショートカットです。

迷った場合は、.xlsxとして保存し、組み込みテーマにはPivotTableStyleTypeを、カスタムテーマにはPivotTableStyleNameを使用してください。

Aspose.Cells for .NETでピボットテーブルを更新する

Net: Aspose.Cells for .NET でピボットテーブルとピボットキャッシュを更新する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells は、ワークブック全体から単一のピボットテーブルまで、4 つの異なるスコープでピボットデータを再読み込みできる階層的な更新 API を提供します。Aspose.Cells for .NET v26.7 以降、従来のメソッド PivotTable.RefreshData() は obsolete（廃止予定）となり、本記事で説明するより効率的でキャッシュ対応の API に置き換える必要があります。

概要

ピボットテーブルの更新は、単一の操作であることは稀です。内部的には、Aspose.Cells は元のソースデータとワークシートに表示されるレンダリング済みの値を結ぶ階層的なデータチェーンを維持しています。このチェーンを理解することが、あらゆる状況において適切な更新 API を選択する鍵となります。

4 層のデータチェーンは次のとおりです。

データソース — 元のワークシート範囲、データベースクエリ、または統合範囲。生データがここに存在します。
PivotCache — ソースデータのインメモリスナップショットです。すべてのピボットテーブルは PivotCache の上に構築され、すべてのデータはこの場所で収集・集計されます。
PivotTable — 行、列、値、フィルタフィールドを定義するビューオブジェクトです。PivotTable はデータソースから直接ではなく、PivotCache からのみ読み取ります。
Cells — PivotTable が計算済みの値やスタイルを描画する先のワークシートの Cells。

特に重要な概念は 共有キャッシュ です。ワークブック内の複数のピボットテーブルが同じソース範囲を参照している場合、それらは 1 つの PivotCache インスタンスを共有します。1 つの PivotCache は多くのピボットテーブルから参照でき、そのキャッシュを更新すると、依存するすべての PivotTable が一度に更新されます。

PivotCache.SourceType（列挙型 PivotTableSourceType）は、キャッシュデータの取得元を示します。v26.7 時点で、PivotCache.Refresh() は Sheet および Consolidation のソースタイプ、つまりワークシート範囲に存在するデータのみをサポートしています。外部ソース（データベース、外部接続など）は、まだキャッシュ API 経由では更新できません。

このチェーンのため、Aspose.Cells には 2 つの基本的な更新パスがあります。

PivotCache.Refresh() — ソースからキャッシュへデータを再読み込みし、依存するすべての PivotTable を 1 回の操作で再計算します。
PivotTable.CalculateData() — 既にキャッシュされたデータから、1 つの PivotTable の表示を再計算します。データソースへのラウンドトリップは行いません。

本記事のすべてのシナリオではワークシートセルのソースデータを使用しているため、ソースタイプは Sheet であり、更新操作は説明したとおりに動作します。

必要な Using ディレクティブ

本記事のすべての C# コード例は、ピボットタイプが Aspose.Cells.Pivot 名前空間に存在するため、以下の 3 つの using ディレクティブから始まります。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

ワークブック内のすべてのピボットテーブルを更新する

ワークブック内のすべてのピボットキャッシュとすべてのピボットテーブルが最新のソースデータを反映するようにする必要がある場合、最もシンプルで包括的な API は Workbook.RefreshAll() です。1 回の呼び出しでワークブック全体を走査し、各 PivotCache をソースから更新し、その後、依存するすべての PivotTable を再計算します。これは、パフォーマンスが問題にならない一般的なドキュメント全体の更新に対して推奨されるアプローチです。

次の例では、Fruit/Year/Amount のソース範囲を持つワークブックを作成し、1 つのピボットテーブルを作成し、一部のソース値を変更してから、RefreshAll() を使用してすべてを 1 回の呼び出しで最新の状態にしています。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 新しいワークブックを作成
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// A1:C1のセルにヘッダー行を書き込み
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// A2:C9のセルにデータ行を書き込み（2020年と2021年にわたる8行のフルーツデータ）
worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(50);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(60);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(70);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(80);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(90);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(100);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(110);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(120);

// ピボットテーブルを追加：ソース範囲「A1:C9」、配置先セル「E3」、名前「Pivot1」
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// ピボットフィールドを割り当て：FruitをRows、YearをColumns、AmountをDataに
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// ソースデータの複数のAmount値を変更して変更をシミュレート
worksheet.Cells["C2"].PutValue(55);
worksheet.Cells["C5"].PutValue(85);
worksheet.Cells["C9"].PutValue(125);

// ワークブック内のすべてのピボットテーブル/ピボットキャッシュを更新
workbook.RefreshAll();

// ワークブックを保存
workbook.Save("output.xlsx");

単一のワークシート上のすべてのピボットテーブルを更新する

特定のワークシート上にあるピボットテーブルだけを更新する必要がある場合があります。たとえば、他のワークシート上のピボットテーブルは無関係であり、触らないことがわかっている場合などです。このケースのために、Aspose.Cells は Worksheet.RefreshPivotTables() を提供しており、単一の Worksheet インスタンスにスコープされます。

これは Workbook.RefreshAll() よりも選択的です。対象となるワークシート上のピボットテーブルのみが更新され、他のワークシート上のピボットテーブルはそのまま残ります。

次の例では、同じ Fruit/Year/Amount のソースデータを入力し、最初のワークシートにピボットテーブルを追加し、一部のソース値を変更してから、そのワークシート上のピボットテーブルのみを更新しています。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2021);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2021);
worksheet.Cells["C5"].PutValue(120);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(180);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2020);
worksheet.Cells["C7"].PutValue(130);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(220);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2020);
worksheet.Cells["C9"].PutValue(140);

int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

worksheet.Cells["C2"].PutValue(300);
worksheet.Cells["C5"].PutValue(250);
worksheet.Cells["C9"].PutValue(400);

worksheet.RefreshPivotTables();

workbook.Save("output.xlsx");

単一のピボットテーブルを更新する

単一のピボットテーブルを細かく制御したい場合、キャッシュベースの API には 2 つのオプションがあります。どちらを選択するかは、実際に変更された内容、つまり基になるソースデータなのか、それともピボットテーブル自体の表示/レイアウト設定のみなのかによって異なります。

ソースデータが変更された場合 — `PivotCache.Refresh()` を使用する

基になるソースデータが変更された場合、正しいエントリポイントは pivotTable.PivotCache.Refresh() です。この呼び出しはソースデータをキャッシュに再読み込みし、そのキャッシュに依存するすべての PivotTable を再計算します。

ピボットテーブルは単一の PivotCache インスタンスを共有するため、PivotCache.Refresh() を呼び出すと、参照している 1 つだけでなく、同じキャッシュ上に構築された すべての ピボットテーブルが再計算されます。2 つのピボットテーブルが同じソース範囲を共有している場合、1 つのキャッシュを更新すると両方が更新されます。

次の例では、同じソース範囲上に 2 つのピボットテーブルを作成し、この共有キャッシュの動作をデモンストレーションし、一部のソース値を変更してから、1 つのキャッシュ参照を介して更新しています。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 新しいワークブックを作成し、最初のワークシートにアクセスします
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// ヘッダー行を書き込みます: Fruit / Year / Amount
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 約9行のデータ行を書き込みます(2020〜2021年にわたる grape / blueberry / kiwi / cherry)
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

// セルE3に配置される最初のピボットテーブル「Pivot1」を追加します。ソース範囲はA1:C9です
int pivotIndex1 = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable1 = worksheet.PivotTables[pivotIndex1];

// Pivot1にフィールドを割り当てます
pivotTable1.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable1.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable1.AddFieldToArea(PivotFieldType.Data, "Amount");

// 同じソース範囲A1:C9を使用して、E15に配置される2番目のピボットテーブル「Pivot2」を追加します
// ソース範囲が同一であるため、Pivot1とPivot2は単一のPivotCacheを共有します。
int pivotIndex2 = worksheet.PivotTables.Add("A1:C9", "E15", "Pivot2");
PivotTable pivotTable2 = worksheet.PivotTables[pivotIndex2];

// Pivot2にも同じフィールドを割り当てます
pivotTable2.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable2.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable2.AddFieldToArea(PivotFieldType.Data, "Amount");

// データ変更をシミュレートするために、ソースデータの複数のAmountセルの値を変更します
worksheet.Cells["C2"].PutValue(150);
worksheet.Cells["C4"].PutValue(350);
worksheet.Cells["C7"].PutValue(650);

// 共有されているPivotCacheを更新します。
// Pivot1とPivot2は同じPivotCacheを共有しているため、この1回の呼び出しで
// 更新されたソースから両方のピボットテーブル(データ+スタイル)を更新します。
pivotTable1.PivotCache.Refresh();

// ワークブックを保存します
workbook.Save("output.xlsx");

表示/レイアウトのみが変更された場合 — `CalculateData()` を使用する

ソースデータは変更されておらず、ピボットテーブルの表示やレイアウト設定のみが変更された場合（たとえば、フィールドが別のエリアに移動された、またはファイルを開くときに更新する設定が切り替えられたなど）、データソースへラウンドトリップする必要はありません。キャッシュにはすでに正しいデータが保持されており、レンダリングされた PivotTable の再計算のみが必要です。この場合、pivotTable.CalculateData() が正しい選択です。

これにより、不要なソースフェッチを回避でき、多くのピボットテーブルが同じキャッシュを共有している場合は大幅に高速になります。

次の例では、ピボットテーブルのソース以外のプロパティを変更し、その後 CalculateData() を呼び出して既存のキャッシュから再レンダリングしています。

using Aspose.Cells;
using Aspose.Cells.Pivot;

var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];

// Fruit / Year / Amount のヘッダー行を書き込み
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 8 つのデータ行を書き込み (2-9 行目、ソース範囲 A1:C9 に適合)
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(150);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(250);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(350);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(450);

// "Pivot1" という名前のピボットテーブルを追加。配置先セル E3、ソース範囲 A1:C9
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.PivotTables[pivotIndex];

// フィールドを割り当て: Fruit を行、Year を列、Amount をデータ
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// 表示/レイアウトプロパティの変更 - これは表示のみの変更です。
// したがって PivotCache.Refresh() を通じてソースデータを再読み込みする必要はありません。
pivotTable.RefreshDataOnOpeningFile = false;

// CalculateData() は、PivotCache に保持されているデータから
// このピボットテーブルの表示 (データ + スタイル) を再レンダリングします。
// ソースデータが変更されていないため、ソースへのラウンドトリップは実行されません -
// キャッシュされた値のみが再計算され、ワークシートのセルに反映されます。
pivotTable.CalculateData();

// ワークブックをディスクに保存
workbook.Save("output.xlsx");

同じ PivotCache を共有するすべてのピボットテーブルを取得する

ワークブックには、1 つの共有キャッシュの上にすべて存在する多くのピボットテーブルが含まれていることがよくあります。これらを列挙するには（たとえば、一括更新を実行する前や、共有キャッシュの影響を診断するために）、PivotCache.GetPivotTables() を使用します。このメソッドは、指定されたキャッシュに依存するすべての PivotTable のコレクションを返します。

これは、2 つのピボットテーブルが実際に同じ PivotCache インスタンスを共有していることを確認する最も直接的な方法でもあります。キャッシュ参照を比較したり、GetPivotTables() が返したコレクションを反復処理してどのピボットテーブルが含まれているかを観察したりできます。

次の例では、同じソース範囲上に 2 つのピボットテーブルを作成し、それらが同じキャッシュインスタンスを共有していることを確認してから、キャッシュのピボットテーブルを列挙しています。

廃止予定の `PivotTable.RefreshData()` からの移行

Aspose.Cells for .NET v26.7 より前では、ピボットテーブルを更新する標準的な方法は、各ピボットテーブルに対して個別に PivotTable.RefreshData() を呼び出すことでした。v26.7 以降、このメソッドは obsolete（廃止予定）としてマークされており、上記で説明したキャッシュ対応の API に置き換える必要があります。

実際のワークブックでは、テーブルごとの RefreshData() アプローチに問題がある理由は 2 つあります。

ソースが変更されていない場合でも、呼び出すたびにソースからデータを再取得します。
呼び出しごとに共有キャッシュ全体が更新されます。多くのピボットテーブルが 1 つのキャッシュを共有している場合、ピボットテーブルごとに RefreshData() を繰り返し呼び出すと、同じキャッシュが何度も再取得されることになり、非常に遅くなります。

推奨される置き換えは次のとおりです。

ワークブック内のすべてのピボットテーブルを更新する → workbook.RefreshAll(); を使用します。
一部のピボットテーブルを更新する → 1 つのキャッシュに対して pivotTable.PivotCache.Refresh(); を使用します。キャッシュは共有されているため、この 1 回の呼び出しでそのキャッシュ上に構築されたすべてのピボットテーブルが更新されます。既に更新されたキャッシュ上に存在する他のピボットテーブルは、安全にスキップできます。
ピボットビュー/レイアウトのみが変更された場合 → ソースへのラウンドトリップなしに既存のキャッシュから再レンダリングするために pivotTable.CalculateData(); を使用します。

次の例では、単一のキャッシュを共有する複数のピボットテーブルを持つワークブックの新しい効率的なパターンを示しています。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 新しいワークブックを作成し、最初のワークシートにアクセスします
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// --- ソースデータを構築: 果物 / 年 / 金額 (ヘッダー + 9行) ---
sheet.Cells["A1"].PutValue("Fruit");
sheet.Cells["B1"].PutValue("Year");
sheet.Cells["C1"].PutValue("Amount");

sheet.Cells["A2"].PutValue("Grape");      sheet.Cells["B2"].PutValue(2020); sheet.Cells["C2"].PutValue(1000);
sheet.Cells["A3"].PutValue("Blueberry");  sheet.Cells["B3"].PutValue(2020); sheet.Cells["C3"].PutValue(2000);
sheet.Cells["A4"].PutValue("Kiwi");       sheet.Cells["B4"].PutValue(2020); sheet.Cells["C4"].PutValue(1500);
sheet.Cells["A5"].PutValue("Cherry");     sheet.Cells["B5"].PutValue(2020); sheet.Cells["C5"].PutValue(2500);
sheet.Cells["A6"].PutValue("Grape");      sheet.Cells["B6"].PutValue(2021); sheet.Cells["C6"].PutValue(3000);
sheet.Cells["A7"].PutValue("Blueberry");  sheet.Cells["B7"].PutValue(2021); sheet.Cells["C7"].PutValue(1800);
sheet.Cells["A8"].PutValue("Kiwi");       sheet.Cells["B8"].PutValue(2021); sheet.Cells["C8"].PutValue(2200);
sheet.Cells["A9"].PutValue("Cherry");     sheet.Cells["B9"].PutValue(2021); sheet.Cells["C9"].PutValue(2700);

// --- 最初のピボットテーブル (Pivot1) を宛先セル E3 に追加 ---
int idx1 = sheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable1 = sheet.PivotTables[idx1];
pivotTable1.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable1.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable1.AddFieldToArea(PivotFieldType.Data, "Amount");

// --- 同じソース範囲に2番目のピボットテーブル (Pivot2) を追加 ---
// Pivot1 と Pivot2 は両方とも1つの基礎となる PivotCache を共有します。
// これはまさに、従来のテーブルごとの RefreshData()
// アプローチが非効率になるシナリオです: 1つのテーブルをリフレッシュすると、
// 共有キャッシュ全体を再取得するため、N個のテーブルをリフレッシュすると
// 同じ高コストの取得がN回行われます。
int idx2 = sheet.PivotTables.Add("A1:C9", "E15", "Pivot2");
PivotTable pivotTable2 = sheet.PivotTables[idx2];
pivotTable2.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable2.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable2.AddFieldToArea(PivotFieldType.Data, "Amount");

// --- ソースデータの複数の金額値を変更 ---
sheet.Cells["C2"].PutValue(5000);   // グレープ 2020
sheet.Cells["C5"].PutValue(7500);   // チェリー 2020
sheet.Cells["C9"].PutValue(9500);   // チェリー 2021

// --- 廃止されたパターン (26.7以前) — PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // ソースから再取得し、キャッシュ全体をリフレッシュ
// pivotTable2.RefreshData();  // 再度再取得 — キャッシュはすでに最新です!
// 各呼び出しで共有キャッシュが再構築されるため、N個のテーブル = N個の冗長な取得。

// --- 新しい v26.7+ パターン: キャッシュを1回リフレッシュし、必要に応じて再レンダリング ---
// PivotCache.Refresh() を1回呼び出すと、変更された値が共有キャッシュに取り込まれ、
// それを参照するすべてのピボットテーブルの表示が再計算されます。
// Pivot1 と Pivot2 は1つの PivotCache を共有しているため、この単一の呼び出しで
// 両方のテーブルが更新されます — 2回目のソースへのラウンドトリップは不要です。
pivotTable1.PivotCache.Refresh();

// CalculateData() はピボットテーブルの表示(データ + スタイル)のみを
// すでにキャッシュに保持されているデータから再レンダリングします — ソースには触れません。
// ここでは API のデモのみを目的として Pivot2 に対して呼び出します: キャッシュが
// 一度リフレッシュされた後は、依存するテーブルはソースに戻ることなく再レンダリングできます。
// ピボットテーブルの表示/レイアウト設定のみが変更され、キャッシュが最新である場合は、
// CalculateData() を単独で使用してください。
pivotTable2.CalculateData();

workbook.Save("output.xlsx");

どの更新 API を使用すべきか？

次の表は、利用可能な更新 API と、それぞれをいつ選択すべきかをまとめたものです。

目的	推奨される API	メモ
ワークブック内のすべてを更新する	`Workbook.RefreshAll()`	1 回の呼び出しで、すべてのキャッシュとテーブルをカバーします。
単一シート上のピボットテーブルだけを更新する	`Worksheet.RefreshPivotTables()`	1 つのワークシートにスコープされます。
1 つのキャッシュのソースデータが変更された	`pivotTable.PivotCache.Refresh()`	その共有キャッシュ上のすべてのピボットテーブルを更新します。
表示/レイアウト設定のみが変更された	`pivotTable.CalculateData()`	不要なソースへのラウンドトリップをスキップします。
共有キャッシュ上のすべてのピボットテーブルを一覧表示する	`pivotCache.GetPivotTables()`	一括更新の前に列挙するために使用します。

実際には、廃止予定のテーブルごとの RefreshData() よりも、キャッシュベースの API を優先してください。これらは共有キャッシュを認識し、冗長なソースフェッチを回避し、更新要件を満たす最小限のスコープを選択できるようにします。

Net: Aspose.Cells for .NET でピボットテーブルの行フィールドと列フィールドを追加する

Mon, 01 Jan 0001 00:00:00 +0000

行領域または列領域へのフィールドの追加

PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) メソッドは、ソースデータから基本フィールドを 4 つのピボット領域のいずれかに移動します。fieldType 引数には、次の PivotFieldType 値のいずれかを使用します。

Row — フィールドは左側に縦方向に表示されます
Column — フィールドは上部に横方向に表示されます
Data — 値が集計されるフィールド
Page — レポートフィルタとして使用されるフィールド

フィールドを追加した後、PivotTable.RowFields プロパティと PivotTable.ColumnFields プロパティからアクセスできます。各プロパティは PivotFieldCollection を返します。RowFields のインデックス 0 のフィールドが最外側の行フィールドであり、後続のインデックスはその内側にネストされたフィールドを表します。同じインデックスの規約が ColumnFields にも適用されます。

フィールドのネスト順序は重要です。最初に Category を行領域に追加し、次に Item を追加すると、外側のグループ化が Category、内側のグループ化が Item になるピボットが作成されます。順序を逆にすると階層構造も逆になります。

ピボットフィールドの小計

PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) メソッドは、ピボットフィールドに対して表示される小計行を制御します。各呼び出しは単一の小計タイプを独立して切り替えます。shown = true を渡すと小計が表示され、shown = false を渡すと非表示になります。各呼び出しは 1 つのタイプにのみ影響するため、異なる subtotalType 値で複数回呼び出すことで、小計のカスタムサブセットを構築できます。

PivotFieldSubtotalType 列挙型は、利用可能な小計の種類を定義します。

Automatic — Aspose.Cells が既定の選択を行います（通常、数値フィールドには Sum）
None — すべての小計行を抑制します
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

小計は、行領域（または列領域）に 2 つ以上のピボットフィールドがある場合にのみ表示されます。1 つのフィールドのみの場合、小計を挟む対象が存在しないため、SetSubtotals を呼び出しても目に見える効果はありません。したがって、この記事ではすべての例で 2 つの行フィールド（外側の Category、内側の Item）を配置し、各 Category グループ間の小計の境界が明確になるようにしています。

シナリオ 1 — 自動（既定）の小計

SetSubtotals をまったく呼び出さない場合、Aspose.Cells は数値フィールドに対して Automatic の選択を適用します。次の例では、外側の Category 行フィールドに対して SetSubtotals(PivotFieldSubtotalType.Automatic, true) を呼び出すことで、この動作を明示的に確認します。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Automatic, true);

pivotTable.CalculateData();

workbook.Save("output_automatic.xlsx");

シナリオ 2 — すべての小計の抑制（None）

SetSubtotals(PivotFieldSubtotalType.None, true) を呼び出すと、ピボットからすべての小計行が削除され、フィールド行と下部にある総合計のみが残ります。これは、要約行のない生のグループ化データが必要な場合に便利です。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

string[] headers = { "Category", "Item", "Year", "Amount" };
for (int j = 0; j < headers.Length; j++)
{
    worksheet.Cells[0, j].PutValue(headers[j]);
}

object[,] data = {
    { "Fruit",     "Apple",  2020, 100 },
    { "Fruit",     "Apple",  2021, 150 },
    { "Fruit",     "Banana", 2020, 80  },
    { "Fruit",     "Banana", 2021, 90  },
    { "Vegetable", "Carrot", 2020, 50  },
    { "Vegetable", "Carrot", 2021, 60  },
    { "Vegetable", "Daikon", 2020, 40  },
    { "Vegetable", "Daikon", 2021, 45  }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    for (int j = 0; j < data.GetLength(1); j++)
    {
        worksheet.Cells[i + 1, j].PutValue(data[i, j]);
    }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.None, true);
pivotTable.CalculateData();

workbook.Save("output_none.xlsx");

シナリオ 3 — カスタム小計サブセット（Sum + Average）

1 つの小計タイプに限定されません。各 SetSubtotals 呼び出しは 1 つのタイプに対して独立して動作するため、Sum と Average のそれぞれに対して 1 回ずつ、計 2 回メソッドを呼び出すことで、各 Category グループに対して 2 つの小計行のカスタムサブセットが生成されます。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells["A1"].PutValue("Category");
worksheet.Cells["B1"].PutValue("Item");
worksheet.Cells["C1"].PutValue("Year");
worksheet.Cells["D1"].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

PivotTableCollection pivotTables = worksheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = pivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Sum, true);
categoryField.SetSubtotals(PivotFieldSubtotalType.Average, true);

pivotTable.CalculateData();

workbook.Save("output_custom.xlsx");

まとめ

上記の 3 つのシナリオは、同じデータセットとピボットテーブル構造を共有しています。它们的唯一区别在于对外部 Category 行字段应用的 SetSubtotals 调用。2 つのフィールドのルールを覚えておいてください。領域に 1 つのフィールドしかない場合、小計を挟む対象がないため、SetSubtotals の目に見える効果を得たいときは常に行領域または列領域に少なくとも 2 つのフィールドを配置してください。

Net: Aspose.Cells for .NET でピボットテーブルの値フィールドを管理する

Mon, 01 Jan 0001 00:00:00 +0000

データ領域へのフィールド追加

ベースフィールドをデータ（値）領域に追加することは、ピボットテーブルがソースデータを集計する方法を形成する最初のステップです。Aspose.Cells は PivotTable.AddFieldToArea(PivotFieldType, string) を提供しており、定数 PivotFieldType.Data とソース列名を受け取るオーバーロードです。データ領域にフィールドが追加されると、API はそれを PivotTable.DataFields コレクションに追加順に公開します。デフォルトでは、数値のソース列は ConsolidationFunction.Sum で集計され、数値以外の列のデフォルトは Count になります。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// A1:D1のヘッダー
worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

// A2:D9のデータ行。jで分岐するネストされたループを使用
for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j < 4; j++)
 {
 switch (j)
 {
 case 0:
 worksheet.Cells[i, j].PutValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i == 1 || i == 2) worksheet.Cells[i, j].PutValue("Apple");
 else if (i == 3 || i == 4) worksheet.Cells[i, j].PutValue("Banana");
 else if (i == 5 || i == 6) worksheet.Cells[i, j].PutValue("Carrot");
 else worksheet.Cells[i, j].PutValue("Daikon");
 break;
 case 2:
 worksheet.Cells[i, j].PutValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i == 1) worksheet.Cells[i, j].PutValue(100);
 else if (i == 2) worksheet.Cells[i, j].PutValue(150);
 else if (i == 3) worksheet.Cells[i, j].PutValue(80);
 else if (i == 4) worksheet.Cells[i, j].PutValue(90);
 else if (i == 5) worksheet.Cells[i, j].PutValue(50);
 else if (i == 6) worksheet.Cells[i, j].PutValue(60);
 else if (i == 7) worksheet.Cells[i, j].PutValue(40);
 else worksheet.Cells[i, j].PutValue(45);
 break;
 }
 }
}

// F3にPivotTable1という名前のピボットテーブルを追加
int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// ピボットレイアウト:行にCategoryとItem、列にYear、データフィールドにAmount
pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

pivotTable.CalculateData();
workbook.Save("output_drag.xlsx");

集計関数の変更

データ領域に配置された各フィールドは内部的に PivotField インスタンスとしてラップされ、その Function プロパティは ConsolidationFunction 列挙体の値を返します。同じ Function セッターを使用すると、Sum、Count、Average、Max、Min、Product、StdDev、StdDevp、Var、Varp を含む利用可能な集計間で切り替えることができます。

Function を変更しても集計のみに影響し、ソース列は変更されません。

したがって、あるデータフィールドを Sum のままにしておきながら、同じソース列を対象とする別のデータフィールドを追加して Count または Average を使用することもできます。これらはすべて単一のピボット内で実現できます。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.Cells[i, j].PutValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 string[] items = { "Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon" };
 worksheet.Cells[i, j].PutValue(items[i - 1]);
 }
 else if (j == 2)
 {
 int[] years = { 2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021 };
 worksheet.Cells[i, j].PutValue(years[i - 1]);
 }
 else
 {
 int[] amounts = { 100, 150, 80, 90, 50, 60, 40, 45 };
 worksheet.Cells[i, j].PutValue(amounts[i - 1]);
 }
 }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");

pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField countField = pivotTable.DataFields[1];
countField.Function = ConsolidationFunction.Count;

pivotTable.CalculateData();

workbook.Save("output_function.xlsx");

値フィールドを行軸または列軸にプロットする

ピボットテーブルに 2 つ以上のデータフィールドが含まれている場合、Aspose.Cells は PivotTable.ValuesField という追加の仮想フィールドを公開します。この仮想フィールドは、データ領域に存在するすべてのデータフィールドの集計を表します。これを行領域または列領域にベースフィールドとしてドラッグすることができ、複数のメジャーを並べて配置する場合に便利です。

PivotTable.ValuesField は、値フィールドが存在しない場合、または 1 つしかない場合には機能しません。

以下のシナリオでは、同じピボット構造に対して、上記で説明した各機能を 3 つのエンドツーエンドの例で順に説明します。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

string[] categories = { "Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable" };
string[] items = { "Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon" };
int[] years = { 2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021 };
int[] amounts = { 100, 150, 80, 90, 50, 60, 40, 45 };

for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.Cells[i, j].PutValue(categories[i - 1]);
 else if (j == 1) worksheet.Cells[i, j].PutValue(items[i - 1]);
 else if (j == 2) worksheet.Cells[i, j].PutValue(years[i - 1]);
 else worksheet.Cells[i, j].PutValue(amounts[i - 1]);
 }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

pivotTable.DataFields[1].Function = ConsolidationFunction.Count;

pivotTable.AddFieldToArea(PivotFieldType.Column, pivotTable.ValuesField.Name);

pivotTable.CalculateData();
workbook.Save("output_plot.xlsx");

Net: Aspose.Cells for .NET でピボットテーブルにフィルターフィールドを追加する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells はピボットテーブル内のフィルターフィールドのライフサイクル全体をサポートします。高レベルの便利な API または低レベルの PageFields コレクションを介してフィルターフィールドを追加でき、単一選択モードでページフィルタを駆動したり、すべてのページアイテムを表示するためにクリアしたり、フィールドを複数選択に切り替えて Excel のチェックボックス UI を通じてユーザーが複数のページアイテムを一度に選択できるようにしたりできます。

はじめに

フィルターフィールドとは、ソースデータのどのサブセットをピボット本体に表示するかを制御するピボットフィールドです。エンドユーザーには、Excel でレンダリングされたピボットの上部にあるドロップダウンとして表示され、利用可能なページアイテムのいずれかを選択すると、そのページアイテムに属するレコードのみが集計されるようにピボット本体が再構築されます。ピボットフィールドは、PivotFieldType.Row、PivotFieldType.Column、または PivotFieldType.Data ではなく PivotFieldType.Page として登録された場合にフィルターフィールドになります。

フィルターフィールドは 2 つの動作で動作できます。デフォルトの単一選択動作では、一度に 1 つのページアイテムのみが表示されるため、ピボット本体は正確に 1 つのサブセットを集計します。複数選択動作では、フィールドはチェックボックスのリストを公開し、ピボット本体はチェックされたすべてのページアイテムの和集合を集計します。同じソースフィールドを、単一のプロパティを切り替えることによって、これらの動作間で前後に移動できます。

Aspose.Cells for .NET は、フィルターフィールドを登録する 2 つの同等の方法を公開しています。高レベル API は PivotTable.AddFieldToArea(PivotFieldType.Page, "fieldName") で、ソース列名を受け取り、単一の呼び出しでフィールドを追加します。低レベル API は PivotTable.PageFields.Add(PivotField) で、すでに PivotField 参照を保持していて、同じフィールドインスタンスをフィルター領域に追加したい場合に使用されます。どちらの API も最終的に同じ PageFields コレクションに格納され、この記事の残りの部分では、それらの間の選択方法と各フィルタリングモードの駆動方法を説明します。

フィルターフィールドの追加

ピボットフィールドをフィルター領域に登録するには 2 つの方法があります。高レベルの呼び出しはソース列名を文字列として受け取り、最も一般的なパスです。低レベルの呼び出しは既存の PivotField インスタンスを受け入れ、同じフィールドオブジェクトを複数のピボット領域間で再利用する場合に便利です。どちらの呼び出しもフィールドを PivotTable.PageFields に配置し、その後、レンダリングされたピボットの上部にページドロップダウンとして表示されます。

AddFieldToArea によるフィルターフィールドの追加

次の例では、小さな Fruit / Year / Amount データセットを構築し、セル E3 にピボットテーブルを配置し、行領域に Fruit、データ領域に Amount、フィルター領域に Year を配置し、ピボットを更新して、ワークブックを保存します。

using System;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 新しいワークブックを作成
var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// ヘッダー行を設定
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// サンプルデータ9行を入力：果物、年、金額
object[,] data = new object[,]
{
    { "apple", 2020, 100 },
    { "banana", 2021, 200 },
    { "apple", 2021, 150 },
    { "grape", 2020, 120 },
    { "orange", 2022, 180 },
    { "banana", 2020, 90 },
    { "grape", 2021, 130 },
    { "apple", 2022, 170 },
    { "orange", 2021, 110 }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    worksheet.Cells[i + 1, 0].PutValue(data[i, 0]);
    worksheet.Cells[i + 1, 1].PutValue(data[i, 1]);
    worksheet.Cells[i + 1, 2].PutValue(data[i, 2]);
}

// セルE3を基準にピボットテーブルを追加
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// 各エリアにフィールドを追加：果物を行、金額をデータ、年をページフィールド
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// ピボットテーブルのデータを更新して計算
pivotTable.CalculateData();

// ワークブックを保存
workbook.Save("pageFieldSample.xlsx");

PageFields.Add によるフィルターフィールドの追加

すでに PivotField インスタンスを操作している場合は、それを直接 PivotTable.PageFields.Add に渡すことができます。ピボットテーブルとフィルターフィールドは前のシナリオとまったく同じ方法で構築されます。最終的なフィルター領域の登録のみが低レベル API 呼び出しに置き換えられます。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — ピボットテーブルとページフィールドは、シナリオ 1a とまったく同じように構築されます
//   (Fruit/Year/Amount データ、ピボットは E3、Fruit→Row、
//   Amount→Data)。以下では、Year PivotField を
//   BaseFields コレクションから取得し、PageFields.Add に渡します。これは
//   AddFieldToArea に代わる低レベルの方法です。結果は
//   機能的にはシナリオ 1a と同じです。

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// ヘッダー
sheet.Cells["A1"].PutValue("Fruit");
sheet.Cells["B1"].PutValue("Year");
sheet.Cells["C1"].PutValue("Amount");

// サンプルデータ (9 行)
sheet.Cells["A2"].PutValue("apple");    sheet.Cells["B2"].PutValue("2020"); sheet.Cells["C2"].PutValue(100);
sheet.Cells["A3"].PutValue("apple");    sheet.Cells["B3"].PutValue("2021"); sheet.Cells["C3"].PutValue(150);
sheet.Cells["A4"].PutValue("apple");    sheet.Cells["B4"].PutValue("2022"); sheet.Cells["C4"].PutValue(200);
sheet.Cells["A5"].PutValue("grape");    sheet.Cells["B5"].PutValue("2020"); sheet.Cells["C5"].PutValue(300);
sheet.Cells["A6"].PutValue("grape");    sheet.Cells["B6"].PutValue("2021"); sheet.Cells["C6"].PutValue(400);
sheet.Cells["A7"].PutValue("grape");    sheet.Cells["B7"].PutValue("2022"); sheet.Cells["C7"].PutValue(500);
sheet.Cells["A8"].PutValue("blueberry"); sheet.Cells["B8"].PutValue("2020"); sheet.Cells["C8"].PutValue(250);
sheet.Cells["A9"].PutValue("blueberry"); sheet.Cells["B9"].PutValue("2021"); sheet.Cells["C9"].PutValue(350);
sheet.Cells["A10"].PutValue("blueberry");sheet.Cells["B10"].PutValue("2022"); sheet.Cells["C10"].PutValue(450);

// E3 に A1:C10 をカバーするピボットテーブルを追加
int pivotIndex = sheet.PivotTables.Add("E3", "A1:C10", "PivotTable1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

// Fruit -> Row、Amount -> Data (Year は下記で Page に追加)
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// 低レベルのアプローチ: 既存の Year PivotField を BaseFields から取得し、
// PageFields.Add(PivotField) 経由で Page 領域に登録します。
PivotField yearField = pivotTable.BaseFields["Year"];
pivotTable.PageFields.Add(yearField);

// 新しいページフィールドが保存されるワークブックに反映されるように更新
pivotTable.CalculateData();

workbook.Save("output.xlsx");

単一選択フィルタリング（1 つのページアイテムの表示）

デフォルトの単一選択動作では、フィルターフィールドは単一のドロップダウンとしてレンダリングされ、PivotField.CurrentPageItem 整数がどのページアイテムがピボット本体を駆動するかを選択します。特定のインデックスを割り当てるとそのアイテムが選択され、特別なセンチネル値 0x7FFD（10 進数で 32765）を割り当てるとフィルタがクリアされ、すべてのページアイテムが一度に集計されます。単一選択がデフォルトであり、明示的に有効にする必要はありません。

すべてのアイテムの表示

CurrentPageItem をマジック値 0x7FFD に設定することは、ページフィルタをクリアすることと同等です。つまり、ピボット本体はフィルタが適用されていないかのようにすべてのページアイテムを集計します。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

class Program
{
    static void Main()
    {
        // 新しいワークブックを作成
        Workbook workbook = new Workbook();
        Worksheet sheet = workbook.Worksheets[0];

        // Fruit/Year/Amount のデータを入力
        sheet.Cells["A1"].PutValue("Fruit");
        sheet.Cells["B1"].PutValue("Year");
        sheet.Cells["C1"].PutValue("Amount");

        object[,] data = new object[,]
        {
            {"Apple", 2022, 100},
            {"Apple", 2023, 150},
            {"Banana", 2022, 80},
            {"Banana", 2023, 120},
            {"Cherry", 2022, 200},
            {"Cherry", 2023, 250}
        };

        for (int r = 0; r < data.GetLength(0); r++)
        {
            for (int c = 0; c < data.GetLength(1); c++)
            {
                sheet.Cells[r + 1, c].PutValue(data[r, c]);
            }
        }

        // E3 にピボットテーブルを作成
        var pivotTables = sheet.PivotTables;
        int index = pivotTables.Add("=A1:C7", "E3", "PivotTable1");
        PivotTable pivotTable = pivotTables[index];

        // ピボットフィールドを設定: Fruit→行、Amount→データ、Year→ページ
        pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
        pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
        pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

        pivotTable.CalculateData();

        // ページフィールドのすべてのアイテムが表示されるようにページフィルターをクリア
        // 0x7FFD (10進数 32765) は「すべてのアイテム」を意味する特別なセンチネル値です —
        // Excel のページフィールドドロップダウンで「(すべて)」を選択するのと同等です。
        pivotTable.PageFields[0].CurrentPageItem = 0x7FFD;

        workbook.Save("output.xlsx");
    }
}

特定の 1 つのアイテムの表示

CurrentPageItem を実際のインデックスに設定すると、そのページアイテムのみが選択されます。インデックスはフィルターフィールドのソート済みアイテムリスト内のアイテムの位置であるため、たとえば 1 を指定すると、ソート後に 2 番目のアイテムが選択されます。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// ワークブックを作成
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
var cells = sheet.Cells;

// サンプルデータを追加 (果物/年/金額)
cells["A1"].PutValue("Fruit");
cells["B1"].PutValue("Year");
cells["C1"].PutValue("Amount");

cells["A2"].PutValue("Apple");
cells["B2"].PutValue("2020");
cells["C2"].PutValue("100");

cells["A3"].PutValue("Apple");
cells["B3"].PutValue("2021");
cells["C3"].PutValue("150");

cells["A4"].PutValue("Banana");
cells["B4"].PutValue("2020");
cells["C4"].PutValue("200");

cells["A5"].PutValue("Banana");
cells["B5"].PutValue("2021");
cells["C5"].PutValue("250");

// E3にピボットテーブルを追加
var pivotTables = sheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables[pivotIndex];

// フィールドを追加: Fruit→行, Amount→データ, Year→ページ
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// ページフィールド固有の操作
pivotTable.PageFields[0].CurrentPageItem = 1; // 1 = ソート順の2番目の項目 (例: "2021")

// ピボットテーブルを更新して計算
pivotTable.CalculateData();

workbook.Save("output.xlsx");

複数選択フィルタリング

複数選択フィルタリングは、ページドロップダウンをチェックボックスのリストに変換し、エンドユーザーが複数のページアイテムを同時に選択できるようにします。Aspose.Cells は連携する 2 つのプロパティを公開しています。PivotField.IsMultipleItemSelectionAllowed は、複数選択 UI が有効になる前に true に設定する必要があります。有効にした後、PivotItem.IsHidden がチェックボックスリストに表示されるアイテムを制御するため、すべてのアイテムを表示するか、特定のアイテムのみをホワイトリストに登録するかを選択できます。

以下のコードは、シナリオ 1a で構築された同じ Year フィルターフィールドで複数選択を有効にし、2 つのパターンを示しています。パート A は、すべてのエントリの IsHidden を false のままにしておくことで、すべてのページアイテムを表示します。一方、パート B は、選択したソース値のみをホワイトリストに登録し、switch (pivotItems[i].GetStringValue()) ブロックを通じて他のすべてを非表示にします。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — ピボットテーブルとページフィールドは、シナリオ 1a とまったく同じ方法で構築されます
//   (Fruit/Year/Amount データ、ピボット位置は E3、Fruit→行、
//   Amount→データ、Year→ページ (AddFieldToArea 経由))
//   以下では、ページフィールドに対して複数選択フィルタを適用します。

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;

// サンプルデータ: Fruit | Year | Amount
cells[0, 0].PutValue("Fruit");
cells[0, 1].PutValue("Year");
cells[0, 2].PutValue("Amount");

string[,] data = new string[,]
{
    { "apple",  "2019", "100" },
    { "apple",  "2020", "150" },
    { "apple",  "2021", "200" },
    { "banana", "2019", "110" },
    { "banana", "2020", "160" },
    { "banana", "2021", "210" },
    { "grape",  "2019", "120" },
    { "grape",  "2020", "170" },
    { "grape",  "2021", "220" }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    cells[i + 1, 0].PutValue(data[i, 0]);
    cells[i + 1, 1].PutValue(Convert.ToInt32(data[i, 1]));
    cells[i + 1, 2].PutValue(Convert.ToInt32(data[i, 2]));
}

Worksheet pivotSheet = workbook.Worksheets.Add("Pivot");
PivotTableCollection pivots = pivotSheet.PivotTables;
int pivotIndex = pivots.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = pivots[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// — ページフィールドで複数選択を有効にする
pivotTable.PageFields[0].IsMultipleItemSelectionAllowed = true;

// パート A — すべての項目を選択する (すべての項目を表示状態にする)
PivotItemCollection pivotItems = pivotTable.PageFields[0].PivotItems;
for (int i = 0; i < pivotItems.Count; i++)
{
    pivotItems[i].IsHidden = false;
}

// パート B — ソース値で特定の項目のみを選択する
for (int i = 0; i < pivotItems.Count; i++)
{
    switch (pivotItems[i].GetStringValue())
    {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems[i].IsHidden = false;
            break;
        default:
            pivotItems[i].IsHidden = true;
            break;
    }
}

pivotTable.CalculateData();

workbook.Save("output.xlsx");

注意: PivotItem.IsHidden を使用して複数選択フィルタリングを使用する場合、少なくとも 1 つの PivotItem は表示されたままにする必要があります（IsHidden == false）。すべてのアイテムが非表示になっている場合、Excel はファイルを開くときにクラッシュするか、空のピボットをレンダリングします。複数選択のホワイトリストにソースデータから少なくとも 1 つのアイテムが含まれていることを必ず確認してください。

どの API とどのモードを使用すべきですか？

次の表は、各シナリオで API とモードをいつ使用するかをまとめたもので、すべてのシナリオを詳細に読まなくても適切な組み合わせを選択できるようにします。

シナリオ / ユースケース	推奨 API	使用するプロパティ	メモ
ソース列名でフィルターフィールドを追加する（最も一般的）	`PivotTable.AddFieldToArea(PivotFieldType.Page, "fieldName")`	なし	高レベル、ワンライン。`PivotField` 参照が必要ない場合はこれを使用してください。
すでに `PivotField` オブジェクトがある場合にフィルターフィールドを追加する	`PivotTable.PageFields.Add(PivotField)`	なし	フィールドオブジェクトが他の場所で取得された場合、または再利用する必要がある場合に使用します。
単一のページアイテムにフィルタリングする（デフォルトモード）	`PivotField.CurrentPageItem`	特定のインデックスに設定	たとえば、`1` はソート済みリストの 2 番目のアイテムを表示します。
すべてのアイテムを表示する / ページフィルタをクリアする	`PivotField.CurrentPageItem`	`0x7FFD` に設定	マジック値 `0x7FFD`（10 進数で 32765）は「すべてのアイテム」のセンチネルです。
Excel で複数選択 UI を有効にする	`PivotField.IsMultipleItemSelectionAllowed`	`true` に設定	`IsHidden` 呼び出しが有効になる前に必要です。
複数選択リスト内の個々のアイテムを表示 / 非表示にする	`PivotItem.IsHidden`	アイテムごとに設定	少なくとも 1 つのアイテムは表示されたままにする必要があります（`IsHidden == false`）。

複数選択フィルタリングを構成するときは、常に可視性の制約を忘れないでください。複数選択フィルターフィールド内のすべての PivotItem が非表示になっている場合、Excel は開く際にクラッシュするか、空のピボットをレンダリングします。ソースデータに基づいてホワイトリストを構築し、少なくとも 1 つのアイテムが表示されたままになるようにして、保存されたワークブックがすべてのマシンで確実に開かれるようにしてください。

Net: ワークシートからのピボットテーブルの削除

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cellsでは、ワークシートからピボットテーブルを削除する機能が提供されています。ピボットテーブルオブジェクトやピボットテーブルの位置を使用して削除できます。

次のサンプルコードでは、ワークシートから2つのピボットテーブルを削除する方法が示されています。最初にWorksheet.PivotTables.Remove()メソッドを使用してピボットテーブルを削除し、次にWorksheet.PivotTables.RemoveAt()メソッドを使用してピボットテーブルを削除します。

Net: ピボットテーブルをODSファイルに保存する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cellsは、ピボットテーブルをODSファイルに保存する機能を提供します。これには、既存のピボットテーブルを含むワークブックを変換するか、新しいピボットテーブルを作成してファイルをODS形式で保存するだけです。出力されるODSファイルでピボットテーブルが表示されるようにするために、保存前にPivotTable.CalculateData()を呼び出すことを確認してください。次のコードスニペットは、ODSファイルにピボットテーブルを保存する方法を示しています。

サンプルコード

上記のコードで生成された出力ファイルが添付されています。

出力ODSファイル

Documentation – ピボットテーブルを挿入する

Net: ピボットテーブルの書式設定

ピボットテーブルの外観

ピボットテーブルの書式オプションの設定

AutoFormat タイプの設定

書式オプションの設定

見た目と手触りの書式設定

ピボットフィールドの書式オプションの設定

行/列/ページフィールドの書式の設定

データフィールドの書式の設定

ピボットフィールドのクリア

Net: ピボットテーブルとピボットチャートの作成

ピボットテーブルとチャートの追加

Aspose.Cellsの使用準備

ピボットテーブルの追加

ピボットチャートの追加

Net: ピボットテーブルとソースデータ

Pivot Tableのソースデータ

ピボットテーブルのデータソースを変更する

Net: ピボットテーブルに計算フィールドを追加する

可能な使用シナリオ

Excelのピボットテーブルに計算フィールドを追加

C#を使用してピボットテーブルに計算フィールドを追加

サンプルコード

Net: Aspose.Cells for .NET でピボットテーブルにスタイルを適用する

はじめに

レガシーXLSプリセット自動書式の適用

モダンな名前付きプリセットピボットテーブルスタイルの適用

カスタムピボットテーブルスタイルの定義と適用

FormatAll で1つのスタイルをすべてのピボットセルに適用する

どのスタイルAPIを使用すべきですか?

関連記事

Net: Aspose.Cells for .NET でピボットテーブルとピボットキャッシュを更新する

概要

必要な Using ディレクティブ

ワークブック内のすべてのピボットテーブルを更新する

単一のワークシート上のすべてのピボットテーブルを更新する

単一のピボットテーブルを更新する

ソースデータが変更された場合 — PivotCache.Refresh() を使用する

表示/レイアウトのみが変更された場合 — CalculateData() を使用する

同じ PivotCache を共有するすべてのピボットテーブルを取得する

廃止予定の PivotTable.RefreshData() からの移行

どの更新 API を使用すべきか？

Net: Aspose.Cells for .NET でピボットテーブルの行フィールドと列フィールドを追加する

行領域または列領域へのフィールドの追加

ピボットフィールドの小計

シナリオ 1 — 自動（既定）の小計

シナリオ 2 — すべての小計の抑制（None）

シナリオ 3 — カスタム小計サブセット（Sum + Average）

まとめ

関連記事

Net: Aspose.Cells for .NET でピボットテーブルの値フィールドを管理する

データ領域へのフィールド追加

集計関数の変更

値フィールドを行軸または列軸にプロットする

Net: Aspose.Cells for .NET でピボットテーブルにフィルターフィールドを追加する

はじめに

フィルターフィールドの追加

AddFieldToArea によるフィルターフィールドの追加

PageFields.Add によるフィルターフィールドの追加

単一選択フィルタリング（1 つのページアイテムの表示）

すべてのアイテムの表示

特定の 1 つのアイテムの表示

複数選択フィルタリング

どの API とどのモードを使用すべきですか？

Net: ワークシートからのピボットテーブルの削除

Net: ピボットテーブルをODSファイルに保存する

サンプルコード

ソースデータが変更された場合 — `PivotCache.Refresh()` を使用する

表示/レイアウトのみが変更された場合 — `CalculateData()` を使用する

廃止予定の `PivotTable.RefreshData()` からの移行