开源 .NET 库，用于 PowerPoint 演示文稿

Aspose.Slides FOSS for .NET 是一个 MIT 许可证的纯 C# 库，用于处理 PowerPoint .pptx 文件。只需添加一个 NuGet 包，即可立即开始创建、读取和编辑演示文稿，无需安装 Microsoft Office 或任何专有运行时。

该库提供了围绕 Presentation、Slide、Shape、TextFrame、Paragraph 和 Portion 构建的 Presentation API，这些是 PowerPoint 本身使用的概念模型。可以添加和删除幻灯片，插入 AutoShape、表格和连接线，在字符层面格式化文本（加粗、斜体、字号和颜色），应用纯色或渐变填充，并添加视觉效果（阴影、发光、模糊、反射）。

IDisposable 模式确保可靠的资源清理：始终在 using 语句中包装 Presentation。加载时遇到的未知 XML 部分在保存时会原样保留，因此往返操作永不会破坏库尚未理解的内容。该库要求 .NET 9.0 或更高版本，并且没有需要编译的本机扩展。

演示文稿和幻灯片 API

创建和打开 PPTX： 通过 new Presentation() 或 new Presentation(file) 创建新演示文稿或打开已有的 .pptx 文件。
添加和删除幻灯片： 使用 AddClone()、AddEmptySlide()、Remove() 和 RemoveAt() 以编程方式管理 SlideCollection。
AutoShape： 通过 AddAutoShape() 插入矩形、椭圆、直线以及其他 ShapeType 几何形状。
表格和连接线： 使用 AddConnector() 添加结构化的表格形状和形状之间的连接线。
演讲者备注： 通过 NotesSlideManager 读取和写入每张幻灯片的演讲者备注。
线程式评论： 使用 GetSlideComments() 访问幻灯片级别的评论线程。

Aspose.Slides FOSS 可用于何处

报告生成： 在无需 Office 的情况下，从数据源构建品牌化的幻灯片套件。
模板自动化： 在 CI/CD 流水线中使用动态内容填充 PPTX 模板。
内容迁移： 读取现有演示文稿并重新组织或重新样式化幻灯片。
无服务器后端： 在 Docker 容器或 Azure Functions 中处理 PPTX 文件。
批处理： 对大型幻灯片库应用统一的格式更改。

文本格式化与视觉效果

字符级格式化： 通过 PortionFormat 对单个 Portion 对象应用粗体、斜体、字体大小和颜色。
纯色和渐变填充： 使用 FillFormat 和 FillType 将形状填充设为纯色或多节点线性渐变。
阴影和发光效果： 通过 EffectFormat 为任意形状应用外部阴影、发光、模糊和反射。
段落对齐： 使用 ParagraphFormat.Alignment 为每个段落设置左对齐、居中、右对齐或两端对齐。
往返安全： 未知的 XML 部分在重新保存时会原样保留。

开发者体验

Aspose.Slides FOSS 安装只需一条 dotnet add package Aspose.Slides.Foss 命令。该库纯 C#，没有需要编译的本机扩展，也无需安装系统软件包。

API 镜像 PowerPoint 自身的对象模型（Presentation、Slide、Shape、TextFrame、Paragraph、Portion），因此熟悉 PowerPoint 对象模型的用户可以立即使用该库。它采用 MIT 许可证，在 GitHub 上开源，且需要 .NET 9.0 或更高版本。

创建演示文稿并添加形状

使用 using 语句确保 Presentation 始终被释放并释放资源。AddAutoShape() 接受 ShapeType 枚举，然后是以点为单位的 x/y 位置和宽度/高度——形状的 TextFrame.Text 属性可在一行中设置标签。

dotnet add package Aspose.Slides.Foss

using Aspose.Slides.Foss;

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

// 添加一个矩形 AutoShape
var shape = slide.Shapes.AddAutoShape(
    ShapeType.Rectangle, 50, 50, 400, 150
);
shape.TextFrame.Text = "你好，Aspose.Slides！";

prs.Save("output.pptx", SaveFormat.Pptx);

格式化文本并应用填充效果

文本格式化在 Portion 级别工作——它是字符运行的最小单元。打开已保存的文件，导航到第一段的第一个 portion，并直接设置字体属性。形状填充是独立的：将 FillType 设置为 Solid 并将颜色分配给 SolidFillColor.Color。

using Aspose.Slides.Foss;

using var prs = new Presentation("output.pptx");
var shape = prs.Slides[0].Shapes[0];
var portion = shape.TextFrame.Paragraphs[0].Portions[0];

// 粗体，18pt，深蓝色文字
portion.PortionFormat.FontBold = NullableBool.True;
portion.PortionFormat.FontHeight = 18;
portion.PortionFormat.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 0, 0, 139);

// 对形状进行实心背景填充
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 240, 248, 255);

prs.Save("formatted.pptx", SaveFormat.Pptx);

常见问题