在 .NET 中保存演示文稿

概述

Open Presentations in C# 介绍了如何使用 Presentation 类打开演示文稿。本文章说明如何创建和保存演示文稿。Presentation 类包含演示文稿的内容。无论是从头创建演示文稿还是修改现有演示文稿，完成后都需要保存。使用 Aspose.Slides for .NET，您可以保存为文件或流。本文解释了保存演示文稿的不同方式。

将演示文稿保存为文件

通过调用 Presentation 类的 Save 方法将演示文稿保存到文件。向该方法传递文件名和保存格式。下面的示例演示了如何使用 Aspose.Slides 保存演示文稿。

// 实例化表示演示文稿文件的 Presentation 类。
using (Presentation presentation = new Presentation())
{
    // 在此执行一些操作...
    
    // 将演示文稿保存到文件。
    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

将演示文稿保存到流

您可以通过将输出流传递给 Presentation 类的 Save 方法，将演示文稿保存到流。演示文稿可以写入多种流类型。下面的示例中，我们创建一个新演示文稿并将其保存到文件流。

// 实例化表示演示文稿文件的 Presentation 类。
using (Presentation presentation = new Presentation())
{
    using (FileStream fileStream = new FileStream("Output.pptx", FileMode.Create))
    {
        // 将演示文稿保存到流中。
        presentation.Save(fileStream, SaveFormat.Pptx);
    }
}

使用预定义视图类型保存演示文稿

Aspose.Slides 通过 ViewProperties 类允许您设置生成的演示文稿打开时 PowerPoint 使用的初始视图。将 LastView 属性设置为来自 ViewType 枚举的值。

using (Presentation presentation = new Presentation())
{
    presentation.ViewProperties.LastView = ViewType.SlideMasterView;
    presentation.Save("SlideMasterView.pptx", SaveFormat.Pptx);
}

以严格的 Office Open XML 格式保存演示文稿

Aspose.Slides 允许您以严格的 Office Open XML 格式保存演示文稿。保存时使用 PptxOptions 类并设置其 conformance 属性。如果将其设为 Conformance.Iso29500_2008_Strict，输出文件将以严格的 Office Open XML 格式保存。

下面的示例创建一个演示文稿并以严格的 Office Open XML 格式保存。

PptxOptions options = new PptxOptions()
{
    Conformance = Conformance.Iso29500_2008_Strict
};

// 实例化表示演示文稿文件的 Presentation 类。
using (Presentation presentation = new Presentation())
{
    // 以严格的 Office Open XML 格式保存演示文稿。
    presentation.Save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
}

在 Zip64 模式下以 Office Open XML 格式保存演示文稿

Office Open XML 文件是一个 ZIP 存档，对任何文件的未压缩大小、压缩后大小以及存档的总大小均限制为 4 GB（2^32 字节），并且存档中的文件数量限制为 65,535（2^16‑1）个。ZIP64 格式扩展将这些限制提升至 2^64。

IPptxOptions.Zip64Mode 属性允许您在保存 Office Open XML 文件时选择何时使用 ZIP64 格式扩展。

此属性提供以下模式：

IfNecessary 仅在演示文稿超出上述限制时使用 ZIP64 格式扩展。这是默认模式。
Never 从不使用 ZIP64 格式扩展。
Always 总是使用 ZIP64 格式扩展。

以下代码演示了如何在保存为 PPTX 文件时启用 ZIP64 格式扩展：

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("OutputZip64.pptx", SaveFormat.Pptx, new PptxOptions()
    {
        Zip64Mode = Zip64Mode.Always
    });
}

NOTE

当您使用 Zip64Mode.Never 保存时，如果演示文稿无法以 ZIP32 格式保存，将抛出 PptxException。

在 Office Open XML 格式中使用压缩级别保存演示文稿

处理大型演示文稿时，您可以调整压缩级别，以平衡文件大小和处理时间。根据需求，您可能更偏好更快的处理速度或更小的输出文件。

Aspose.Slides 提供了 IPptxOptions.CompressionLevel 属性，允许您指定在以 Office Open XML 格式保存演示文稿时使用的压缩级别。

以下压缩级别可供选择：

None：不进行压缩，文件按原样保存。
Level1：最快的压缩，压缩率最低。
Level2：比 Level1 稍快且压缩率略好。
Level3：在处理中等影响下，提供比 Level2 更好的压缩。
Level4：提供比 Level3 更好的压缩。
Level5：在额外的处理时间下，提供比 Level4 更好的压缩。
Level6：标准压缩，在处理速度和文件大小之间取得良好平衡。这是 默认压缩级别。
Level7：提供比 Level6 更好的压缩，但处理速度更慢。
Level8：提供比 Level7 更好的压缩。
Level9：最高压缩率，产生最小文件大小，但需要最长的处理时间。

以下示例演示了如何将演示文稿保存为 无压缩 的 PPTX 文件：

using (Presentation pres = new Presentation("Sample.pptx"))
{
    pres.Save("Sample-out.pptx", SaveFormat.Pptx, new PptxOptions
    {
        CompressionLevel = CompressionLevel.None
    });
}

此示例展示了如何将演示文稿保存为 最高压缩 的 PPTX 文件：

using (Presentation pres = new Presentation("Sample.pptx"))
{
    pres.Save("Sample-level9.pptx", SaveFormat.Pptx, new PptxOptions
    {
        CompressionLevel = CompressionLevel.Level9
    });
}

保存演示文稿时不刷新缩略图

在将演示文稿保存为 PPTX 时，PptxOptions.RefreshThumbnail 属性控制缩略图的生成：

如果设置为 true，保存时会刷新缩略图。这是默认设置。
如果设置为 false，则保留当前缩略图。如果演示文稿没有缩略图，则不会生成。

下面的代码将演示文稿保存为 PPTX，且不刷新其缩略图。

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("Output.pptx", SaveFormat.Pptx, new PptxOptions()
    {
        RefreshThumbnail = false
    });
}

Info

此选项有助于缩短保存 PPTX 格式演示文稿所需的时间。

以百分比获取保存进度更新

IProgressCallback 接口通过 ISaveOptions 接口公开的 ProgressCallback 属性以及抽象的 SaveOptions 类使用。将 IProgressCallback 的实现分配给 ProgressCallback，即可以百分比形式接收保存进度更新。

下面的代码片段演示了如何使用 IProgressCallback。

ISaveOptions saveOptions = new PdfOptions();
saveOptions.ProgressCallback = new ExportProgressHandler();

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("Output.pdf", SaveFormat.Pdf, saveOptions);
}

class ExportProgressHandler : IProgressCallback
{
    public void Reporting(double progressValue)
    {
        // 在此使用进度百分比值。
        int progress = Convert.ToInt32(progressValue);

        Console.WriteLine(progress + "% of the file has been converted.");
    }
}

Info

Aspose 使用其自身 API 开发了一个免费 PowerPoint 拆分器应用。该应用可通过将选定的幻灯片另存为新的 PPTX 或 PPT 文件，将演示文稿拆分为多个文件。

常见问题

是否支持“快速保存”（增量保存）仅写入更改？

不支持。每次保存都会重新创建完整的目标文件，不支持增量的“快速保存”。

从多个线程保存同一 Presentation 实例是否线程安全？

不安全。Presentation 实例非线程安全，请在单个线程中进行保存。

保存时超链接和外部链接文件会怎样？

超链接会被保留。外部链接文件（例如通过相对路径引用的视频）不会自动复制——请确保引用的路径仍然可访问。

我可以设置/保存文档元数据（作者、标题、公司、日期）吗？

可以。支持标准的文档属性，保存时会写入文件中。

在 .NET 中将演示文稿转换为多种格式在 .NET 中管理幻灯片放映