如何在 .NET 中加载演示文稿

Aspose.Slides FOSS for .NET 允许您打开任何 .pptx 文件，检查其内容，并可以将其保存回 PPTX 或从中提取数据。本指南涵盖打开文件、遍历幻灯片、读取形状文本以及往返保存。

分步指南

步骤 1：安装软件包

dotnet add package Aspose.Slides.Foss

步骤 2：打开现有演示文稿

将文件路径传递给 new Presentation()。使用 using 语句以确保清理。

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation("input.pptx");
Console.WriteLine($"Slide count: {prs.Slides.Count}");
prs.Save("output.pptx", SaveFormat.Pptx);

源文件中未知的 XML 部分会原样保留：库从不删除它尚未理解的内容。

步骤 3：检查幻灯片

遍历所有幻灯片并打印它们的索引：

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
for (int i = 0; i < prs.Slides.Count; i++)
{
    var slide = prs.Slides[i];
    int shapeCount = slide.Shapes.Count;
    Console.WriteLine($"Slide {i}: {shapeCount} shapes");
}

步骤 4：读取形状文本

遍历形状并读取具有 TextFrame 的形状中的文本：

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
foreach (var slide in prs.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IAutoShape autoShape && autoShape.TextFrame != null)
        {
            string text = autoShape.TextFrame.Text;
            if (!string.IsNullOrWhiteSpace(text))
                Console.WriteLine($"  Shape text: {text}");
        }
    }
}

步骤 5：读取文档属性

从 prs.DocumentProperties 访问核心文档属性：

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
var props = prs.DocumentProperties;
Console.WriteLine($"Title:   {props.Title}");
Console.WriteLine($"Author:  {props.Author}");
Console.WriteLine($"Subject: {props.Subject}");

步骤 6：往返保存

检查或修改演示文稿后，将其保存回 PPTX：

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

保存到不同的路径会创建一个新文件。保存到相同的路径会覆盖原文件。

常见问题及解决方案

FileNotFoundException

检查相对于工作目录的 .pptx 文件路径是否正确。使用 Path.Combine 进行稳健的路径构建：

string path = Path.Combine(AppContext.BaseDirectory, "assets", "deck.pptx");
using var prs = new Presentation(path);

Exception: File format is not supported

该库仅支持 .pptx（Office Open XML），不支持旧版 .ppt（二进制 PowerPoint 97-2003）文件。

形状没有 TextFrame 属性

某些形状（Connector，PictureFrame）没有 TextFrame。在转换为 IAutoShape 并在访问文本之前检查是否为 null。

常见问题

加载是否保留所有原始内容？

是的。未知的 XML 部分在往返保存时会原样保留。该库不会删除任何它尚未识别的 XML 内容。

我可以加载受密码保护的 PPTX 吗？

此版本不支持受密码保护（加密）的演示文稿。

我可以提取嵌入的图像吗？

访问图像集合：prs.Images 返回 ImageCollection。每个图像都有属性可读取原始图像数据。

是否支持从 MemoryStream 加载？

是的。Presentation 构造函数接受一个 Stream：

using var stream = new MemoryStream(pptxBytes);
using var prs = new Presentation(stream);
Console.WriteLine($"Slides: {prs.Slides.Count}");