PowerPoint VSTO项目中如何读取瀑布图的分类名称？

阿华AIGC实验室

2026-5-20

解决PowerPoint VSTO中读取瀑布图分类名称的问题

嘿，我之前在做PowerPoint VSTO项目时也碰到过一模一样的瀑布图分类名称读取问题！那些常规的Series属性确实对瀑布图不生效，因为这类图表的结构和普通柱形图/折线图不一样，得换个思路来获取分类名。

正确的获取方式：直接访问图表的分类轴

瀑布图的分类名称是绑定在图表的**主分类轴（Primary Category Axis）**上的，而非单个Series。你可以通过Chart.Axes对象直接获取分类轴的Categories属性来拿到所有分类名称，代码示例如下（C#）：

using Microsoft.Office.Core;
using Microsoft.Office.Interop.PowerPoint;

// 假设你已经获取到目标Chart对象（比如从Slide.Shapes里拿到）
Chart targetChart = ...;

// 获取主分类轴
Axis categoryAxis = targetChart.Axes(XlAxisType.xlCategory, XlAxisGroup.xlPrimary);

// 获取所有分类名称集合
object categories = categoryAxis.Categories;
// 将集合转为可遍历的dynamic类型（适配COM集合的特性）
dynamic categoryCollection = categories;

// 遍历输出每个分类名称
for (int i = 1; i <= categoryCollection.Count; i++)
{
    string categoryName = categoryCollection[i];
    // 替换为你的业务处理逻辑
    Console.WriteLine($"分类名称：{categoryName}");
}

为什么你之前的方法不生效？

chart.SeriesCollection(x).Axes(y).CategoryNames / chart.SeriesCollection(x).XValues：瀑布图的Series不支持这些属性，因为它的分类是全局绑定到图表轴的，并非每个Series独立拥有。
Series.Points(y).DataLabel.Text：默认情况下瀑布图的数据标签显示的是数据点的数值，除非你手动设置标签显示分类名称，否则自然拿不到目标内容。