如何在 .NET 中创建演示文稿

Aspose.Slides FOSS for .NET 让您完全使用 C# 创建 PowerPoint 演示文稿，无需依赖 Microsoft Office。本指南展示了如何创建新演示文稿、添加幻灯片和形状、格式化文本以及保存结果。

分步指南

步骤 1：安装软件包

从 NuGet 安装 Aspose.Slides FOSS。需要 .NET 9.0 或更高版本。

dotnet add package Aspose.Slides.Foss

验证安装：

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");

不需要其他系统软件包。

步骤 2：导入所需的命名空间

添加创建和保存演示文稿所需的命名空间。

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

所有形状类型常量位于 Aspose.Slides.Foss.ShapeType。所有格式类型（FillType，NullableBool）也位于 Aspose.Slides.Foss。

步骤 3：创建演示文稿

使用 new Presentation() 与 using 语句。新演示文稿以一个空白幻灯片开始。

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

using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

重要： 始终使用 Presentation 与 using 语句。该类实现了 IDisposable，如果没有它，资源将无法正确释放。

步骤 4：访问幻灯片

第一张幻灯片的索引是 0。空白演示文稿恰好有一张幻灯片。

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

using var prs = new Presentation();
var slide = prs.Slides[0];  // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);

步骤 5：添加形状

使用 slide.Shapes.AddAutoShape() 添加 AutoShape。参数为 (shapeType, x, y, width, height)，全部以点为单位（1 点 = 1/72 英寸；标准幻灯片为 720 x 540 pt）。

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

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

// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);

// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("with-shape.pptx", SaveFormat.Pptx);

第6步：保存演示文稿

在对象被释放之前调用 prs.Save(path, SaveFormat.Pptx)。PPTX 是唯一受支持的输出格式。

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

文件以原子方式写入；如果在此调用之前发生错误，则不会创建输出文件。

完整工作示例

以下程序创建了一个包含两张幻灯片的演示文稿，第一张幻灯片上有标题形状，第二张幻灯片上有表格。

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

using var prs = new Presentation();

// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
    new double[] { 200.0, 120.0, 120.0 },
    new double[] { 40.0, 40.0, 40.0 });

string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
};

for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

for (int row = 0; row < data.Length; row++)
    for (int col = 0; col < data[row].Length; col++)
        table.Rows[row + 1][col].TextFrame.Text = data[row][col];

prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");

常见问题及解决方案

ObjectDisposedException

您在 Presentation 对象的 using 块结束后仍在使用它。所有操作必须在对象被释放之前完成。

缺少命名空间错误 ShapeType

确保在文件顶部有 using Aspose.Slides.Foss;。 ShapeType、NullableBool、FillType，以及其他枚举位于此命名空间。

SaveFormat 除 Pptx 之外

传递任何 SaveFormat 值（除 SaveFormat.Pptx 之外）都不会抛出异常。format 参数被静默忽略，始终生成 PPTX。始终使用 SaveFormat.Pptx 以明确。

常见问题

默认幻灯片尺寸是多少？

一个新的 Presentation() 在标准的 10 x 7.5 英寸（720 x 540 点）尺寸下创建幻灯片。此版本尚不支持更改幻灯片尺寸。

我可以添加多个幻灯片吗？

是的。调用 prs.Slides.AddEmptySlide(prs.LayoutSlides[0]) 以追加空白幻灯片并通过索引访问它：

prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];

我可以打开现有文件并添加幻灯片吗？

是：

using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);

我可以保存为哪些格式？

仅支持 SaveFormat.Pptx。此版本不提供导出为 PDF、HTML、SVG 或图像的功能。