.NET 操作 PowerPoint COM 组件：从零到精通的幻灯片制作实战

图表与 Excel 数据联动

问题

表格可以展示精确数字，但从"看数据"到"看趋势"，中间差一张图表。PowerPoint 的图表系统底层是 Excel——每个 PPT 图表背后都嵌了一个隐藏的 Excel 工作表。这意味着你可以通过程序操作那张工作表的数据，图表会自动响应。

MudTools 在 Shapes.AddChart 方法中封装了整个创建流程，返回的 Shape 通过 HasChart 属性判断。

创建原生图表

using var app = PowerPointFactory.BlankDocument();
var pres = app.ActivePresentation;
var slide = pres.AddSlide(PpSlideLayout.ppLayoutBlank);

// 添加柱状图
var chartShape = slide.Shapes.AddChart(
    type: XlChartType.xlColumnClustered,
    left: 50, top: 80,
    width: 500, height: 350
);

XlChartType 枚举定义了 70+ 种图表类型，常用的：

枚举值	图表类型
xlColumnClustered	簇状柱形图
xlLine	折线图
xlPie	饼图
xlBarClustered	簇状条形图
xlArea	面积图
xlRadar	雷达图
xlStockHLC	股价图

绑定数据源

PowerPoint 图表的数据绑定与传统认知不一样——图表对象自身携带了一个隐藏的 ChartData，其中包含一个 Workbook（Excel 工作簿）。你需要操作这个工作簿来更新图表数据。

IPowerPointShape 当前没有直接暴露 Chart 属性（注释掉了一行 //IPowerPointChart? Chart { get; }）。如果需要操作图表数据，需要通过底层的 COM 对象访问 ChartData。这里展示的是在 MudTools 框架下推荐的变通方案。

方案：通过 IOfficeObject 的 InternalComObject 拿到原生 COM 的 Shape，再获取其 Chart 对象：

// 拿到图表形状后，通过内部 COM 对象操作 ChartData
var nativeShape = (MsPowerPoint.Shape)chartShape;  // 需要转换

nativeShape.Chart.ChartData.Activate();
var workbook = (Excel.Workbook)nativeShape.Chart.ChartData.Workbook;
var sheet = (Excel.Worksheet)workbook.Sheets[1];

// 写入数据
sheet.Cells[1, 1] = "品类";
sheet.Cells[1, 2] = "销售额";
sheet.Cells[2, 1] = "电子产品";
sheet.Cells[2, 2] = 450000;
sheet.Cells[3, 1] = "服装";
sheet.Cells[3, 2] = 320000;
sheet.Cells[4, 1] = "食品";
sheet.Cells[4, 2] = 280000;
sheet.Cells[5, 1] = "家居";
sheet.Cells[5, 2] = 190000;

// 保存并关闭工作簿（这样图表才会刷新）
workbook.Save();
nativeShape.Chart.ChartData.Workbook = null;  // 断开链接

这个过程本质上是在 PPT 内部启动了一个不可见的 Excel 进程，操作完后关闭。需要注意 Excel COM 对象的释放。

修改图表类型、图例、数据标签

图表类型可以在创建后更改：

// 把柱状图改成折线图
var nativeShape = (MsPowerPoint.Shape)chartShape;
var chart = nativeShape.Chart;
chart.ChartType = XlChartType.xlLine;

图例的显隐和位置：

chart.HasLegend = true;
chart.Legend.Position = XlLegendPosition.xlLegendPositionBottom;

数据标签：

// 显示数据标签
chart.ApplyDataLabels(
    Type: XlDataLabelsType.xlDataLabelsShowValue,
    ShowValue: true,
    ShowCategoryName: false
);

从外部 Excel 文件读取数据

实际业务中，数据往往在现成的 Excel 文件里。不需要通过 OLE 嵌入，只需要读取 Excel 数据后写入图表工作簿：

// 读取外部 Excel 数据
string excelPath = @"C:\Data\sales.xlsx";
var dataTable = ReadExcelData(excelPath, "Sheet1");

// 注入到图表工作簿
var nativeShape = (MsPowerPoint.Shape)chartShape;
nativeShape.Chart.ChartData.Activate();
var workbook = nativeShape.Chart.ChartData.Workbook;
var sheet = workbook.Sheets[1];

// 写入表头
sheet.Cells[1, 1] = dataTable.Columns[0].ColumnName;
sheet.Cells[1, 2] = dataTable.Columns[1].ColumnName;

for (int i = 0; i < dataTable.Rows.Count; i++)
{
    sheet.Cells[i + 2, 1] = dataTable.Rows[i][0];
    sheet.Cells[i + 2, 2] = dataTable.Rows[i][1];
}

workbook.Save();

这其中 ReadExcelData 的实现可以用 MudTools.OfficeInterop.Excel 或者其他 Excel 读取库（EPPlus、ClosedXML 等）。

flowchart LR
    A["AddChart(type)"] --> B["PPT 创建隐藏 Excel 实例"]
    B --> C["获取 ChartData.Workbook"]
    C --> D["操作 Worksheets[1] 单元格"]
    D --> E["Workbook.Save()"]
    E --> F["图表自动刷新"]
    F --> G["断开 Workbook 链接"]

应用图表样式

PowerPoint 图表支持快速样式（Quick Layout）和图表样式：

// 应用快速布局
chart.QuickLayout = 2;  // 不同版本数字对应不同布局

// 图表样式（1~48）
chart.ChartStyle = 10;  // 对应 PPT 中的"样式 10"

颜色方案跟随幻灯片的主题颜色方案。如果你调了 slide.ThemeColorScheme，图表颜色会一起变。

完整示例：周报销售趋势图

using MudTools.OfficeInterop;
using MudTools.OfficeInterop.PowerPoint;
using MsPowerPoint = Microsoft.Office.Interop.PowerPoint;
using Excel = Microsoft.Office.Interop.Excel;

using var app = PowerPointFactory.BlankDocument();
var pres = app.ActivePresentation;
var slide = pres.AddSlide(PpSlideLayout.ppLayoutBlank);

// 标题
var title = slide.Shapes.AddTextbox(
    MsoTextOrientation.msoTextOrientationHorizontal,
    30, 20, 600, 40);
title.TextFrame.TextRange.Text = "本周销量趋势";
title.TextFrame.TextRange.Font.Size = 28;
title.TextFrame.TextRange.Font.Bold = true;

// 创建图表
var chartShape = slide.Shapes.AddChart(
    XlChartType.xlColumnClustered, 30, 80, 650, 380);

// 操作数据
var nativeShape = (MsPowerPoint.Shape)chartShape;
nativeShape.Chart.ChartData.Activate();
var wb = nativeShape.Chart.ChartData.Workbook;
var ws = (Excel.Worksheet)wb.Sheets[1];

var days = new[] { "周一", "周二", "周三", "周四", "周五", "周六", "周日" };
var values = new[] { 120, 215, 180, 290, 310, 405, 380 };

ws.Cells[1, 1] = "日期";
ws.Cells[1, 2] = "销量（件）";

for (int i = 0; i < days.Length; i++)
{
    ws.Cells[i + 2, 1] = days[i];
    ws.Cells[i + 2, 2] = values[i];
}

wb.Save();

// 图表美化
var chart = nativeShape.Chart;
chart.ChartStyle = 16;
chart.HasLegend = true;
chart.Legend.Position = XlLegendPosition.xlLegendPositionBottom;
chart.ApplyDataLabels(
    Type: XlDataLabelsType.xlDataLabelsShowValue);

Console.WriteLine("图表生成完成，按回车退出...");
Console.ReadLine();

注意事项

1. Excel 进程残留：ChartData.Activate() 会在后台启动 Excel 进程。操作完成后务必调用 Marshal.ReleaseComObject 释放所有 Excel 相关 COM 引用，否则任务管理器里会留下一堆 EXCEL.EXE。
2. 数据源断开：写入并保存数据后，建议将 Workbook 引用置空（Workbook = null），断开 PPT 与 Excel 的实时链接，避免下次打开 PPT 时弹出外部链接更新提示。
3. 图表类型限制：不是所有 XlChartType 在 PPT 中都支持。PPT 支持大部分 2D 图表，但 3D 图表和极复杂的自定义类型可能出现渲染问题。建议在目标 Office 版本上做验证。
4. 数据量：图表绑定的数据行数不宜超过 100 行。数据量大时图表会变得可读性差，且 PPT 文件打开速度明显变慢。

下一篇文章从预设形状进入——矩形、箭头、连接线、自由曲线，以及如何通过 Group 和 ZOrder 管理复杂图形的层级。