Как начать работу с Aspose.Slides FOSS для .NET

Aspose.Slides.Foss для .NET — бесплатная библиотека с лицензией MIT для создания и редактирования файлов PowerPoint .pptx — без необходимости Microsoft Office, доступна в NuGet.

Пошаговое руководство

Шаг 1: Установить пакет

Установить из NuGet (требуется .NET 9.0 или новее):

dotnet add package Aspose.Slides.Foss

Проверьте установку, собрав проект:

dotnet build

Шаг 2: Импортировать необходимые пространства имён

Добавьте директивы using, необходимые для загрузки презентаций и сохранения:

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

Шаг 3: Создать презентацию

Создайте Presentation без аргументов, чтобы начать с одного пустого слайда. Всегда используйте
using, чтобы гарантировать освобождение внутренних ресурсов:

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

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

Шаг 4: Добавить форму с текстом

Используйте slide.Shapes.AddAutoShape(), чтобы вставить прямоугольник, затем вызовите AddTextFrame()
чтобы добавить текстовое содержимое:

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

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 150);
var tf = shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 24;
fmt.FontBold = NullableBool.True;
prs.Save("with_shape.pptx", SaveFormat.Pptx);

Шаг 5: Применить заливку и сохранить

Установите сплошной цвет заливки для фигуры перед сохранением:

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

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 200);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 70, 130, 180);
shape.AddTextFrame("Styled shape");
prs.Save("styled.pptx", SaveFormat.Pptx);

Распространённые проблемы и их решения

TypeLoadException or DllNotFoundException
Убедитесь, что вы нацелены на .NET 9.0 или более позднюю версию. Библиотека требует .NET 9.0+. Обновите ваш
.csproj файл: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException при вызове некоторых методов
Некоторые функции (диаграммы, анимации, экспорт PDF) не поддерживаются в этом выпуске.
Проверьте справочник API для списка ограничений перед использованием расширенных функций.

ObjectDisposedException после блока using
Не используйте экземпляр Presentation за пределами его блока using. Получите доступ ко всем слайдам, фигурам и текстовым кадрам до выхода блока using.

Файл не сохранён корректно Всегда передавайте значение перечисления SaveFormat в Save(). Перегрузка Save(path, SaveFormat.Pptx) записывает файл в формате PPTX.

Часто задаваемые вопросы

Требуется ли Microsoft Office для Aspose.Slides.Foss?

Нет. Библиотека создает и читает файлы .pptx нативно на чистом C# без зависимости от Microsoft Office, COM‑автоматизации или Windows API.

Какие версии .NET поддерживаются?

.NET 9.0 или новее. Библиотека работает на Windows, macOS, Linux и в Docker‑контейнерах.

Библиотека бесплатна для коммерческого использования?

Да. Он выпущен под лицензией MIT. Вы можете использовать, модифицировать и распространять его для любой цели, включая коммерческие приложения.

Могу ли я загрузить существующий файл PPTX?

Да. Передайте путь к файлу в конструктор Presentation:

using var prs = new Presentation("existing.pptx");
Console.WriteLine($"Loaded {prs.Slides.Count} slides");
prs.Save("copy.pptx", SaveFormat.Pptx);

Нужно ли вызывать Dispose явно?

Да, через оператор using. Presentation реализует IDisposable и должен быть освобождён для высвобождения файловых дескрипторов и внутренних ресурсов.