PPT 页面自动化：C# 实现幻灯片增加、删除、复制、隐藏

在自动化处理 PPT 模板、批量整理幻灯片、动态调整页面顺序的场景中，经常需要对幻灯片本身做管理操作：新增、删除、复制、显示 / 隐藏。本文基于 Free Spire.Presentation for .NET 免费库介绍如何完成这些灯片页面管理相关操作，无需 Office 依赖。

免费版可以用于 PPT/PPTX 的创建与修改，但需注意在读写文档时幻灯片总数不能超过 10 页，适合中小体量场景。

环境配置与核心对象

通过 NuGet 安装：

dotnet add package FreeSpire.Presentation

命名空间为 Spire.Presentation。幻灯片管理围绕两个核心类型展开：Presentation 是整个演示文稿的入口，Presentation.Slides 是幻灯片集合，集合中的每一项是 ISlide。所有增、删、复制、重排操作最终都落在这个集合上。

Presentation 实现了 IDisposable，涉及文件读写时建议用 using 声明，确保句柄及时释放。

新增幻灯片

实例化 Presentation 时，库会自动附带一张空白幻灯片。如果要从零开始构建，先移除这张默认页：

using var ppt = new Presentation();
ppt.Slides.RemoveAt(0);

之后有两种添加方式：

ppt.Slides.Append();    // 在末尾追加一张空白幻灯片
ppt.Slides.Insert(1);   // 在索引 1 处插入空白幻灯片（索引从 0 起）

Append() 不带参数时追加空白页，Insert(index) 同样是插入空白页，二者都不会带入任何已有内容。

删除幻灯片

按索引或对象引用删除：

ppt.Slides.RemoveAt(0);           // 按索引删除
ISlide target = ppt.Slides[2];
ppt.Slides.Remove(target);        // 按对象引用删除

删除前应校验 ppt.Slides.Count > index，避免越界。如果要批量删除，必须倒序遍历：

for (int i = ppt.Slides.Count - 1; i >= 0; i--)
{
    if (ShouldDelete(ppt.Slides[i]))
        ppt.Slides.RemoveAt(i);
}

正序循环中调用 RemoveAt 会导致后续元素的索引前移，出现漏删或越界。

复制幻灯片

复制通过向 Append 或 Insert 传入一个已有的 ISlide 对象来完成，布局、图片和格式会被保留。

同一文档内复制：

ISlide source = ppt.Slides[0];
ppt.Slides.Append(source);      // 复制到末尾
ppt.Slides.Insert(2, source);   // 复制并插入到索引 2

跨文档复制不需要额外转换，直接把源文档的 ISlide 传入目标文档的集合即可：

using var sourcePpt = new Presentation();
sourcePpt.LoadFromFile("source.pptx");
using var targetPpt = new Presentation();

targetPpt.LoadFromFile("target.pptx");
ISlide toCopy = sourcePpt.Slides[0];

targetPpt.Slides.Insert(0, toCopy);

从代码形态上看，“复制”与“插入空白页”的区别仅在于 Insert 的第二个参数是否为 ISlide 对象。

隐藏幻灯片

ISlide 暴露了布尔属性 Hidden，用于控制在放映时是否跳过该幻灯片：

ppt.Slides[1].Hidden = true;   // 隐藏第 2 张
ppt.Slides[1].Hidden = false;  // 取消隐藏

隐藏行为与 PowerPoint 中的语义一致：放映时跳过，编辑视图中仍然可见、可编辑。隐藏不改变 Slides 集合的结构，因此批量设置时不需要倒序遍历。

以上 API 覆盖了幻灯片页面层面最常用的管理操作：新增、删除、复制、隐藏。适合用来做 PPT 页面批量整理、模板动态分页、按需控制放映页面等自动化场景。