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

Aspose.Slides FOSS for .NET lets you open any .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：读取形状文本

遍历形状并读取具有 a 的形状的文本 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 (binary 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}");