Введение

Aspose.Slides FOSS for .NET теперь доступен на NuGet: бесплатная библиотека с лицензией MIT для создания, чтения и редактирования файлов PowerPoint .pptx полностью на C#, без зависимости от Microsoft Office или какого‑либо проприетарного runtime.

Библиотека предназначена для разработчиков, которым необходимо программно генерировать или манипулировать файлами презентаций: автоматизировать создание наборов слайдов из данных, извлекать текст и метаданные из загруженных файлов PPTX, строить конвейеры отчетности на основе презентаций или встраивать создание презентаций в приложения ASP.NET. Поскольку Aspose.Slides.Foss требует .NET 9.0 или новее, она развертывается одинаково на Windows, macOS, Linux и в Docker‑контейнерах.

Ключевые особенности

  • Полная поддержка обратного цикла PPTX: Откройте любой файл .pptx, измените его содержимое и сохраните обратно, не теряя неизвестные XML‑части, которые библиотека пока не понимает.
  • Управление слайдами: Добавляйте, удаляйте и перебирайте слайды с помощью prs.Slides; презентация начинается с одного пустого слайда после new Presentation().
  • AutoShape, таблицы и соединители: Вставляйте фигуры через slide.Shapes.AddAutoShape(), табличные данные через slide.Shapes.AddTable() и визуальные соединители между фигурами через slide.Shapes.AddConnector().
  • Форматирование текста: Форматируйте текст на уровне символов с помощью PortionFormat: размер шрифта, полужирный, курсив, подчеркивание и цвет ARGB через FillType.Solid и ColorFormat.
  • Типы заливки: Применяйте заливки FillType.Solid, Gradient, Pattern или Picture к любой фигуре.
  • Визуальные эффекты: Внешняя тень, сияние, мягкий край, размытие, отражение и внутренняя тень через shape.EffectFormat.
  • 3D‑форматирование: Фаска, камера, система освещения, материал и глубина выдавливания через shape.ThreeDFormat.
  • Заметки докладчика: Прикрепляйте текст заметок к каждому слайду через NotesSlideManager.AddNotesSlide().
  • Ветвящиеся комментарии: Добавляйте комментарии с метаданными автора и позицией на слайде.
  • Встроенные изображения: Встраивайте из пути к файлу, байтов или Stream.
  • Свойства документа: Читайте и записывайте основные, приложенческие и пользовательские свойства.

Начало работы

Установите из NuGet. Требуется .NET 9.0 или новее.

dotnet add package Aspose.Slides.Foss

Создайте свою первую презентацию с фигурой и сохраните её:

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, 120);
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
prs.Save("hello.pptx", SaveFormat.Pptx);

Всегда используйте Presentation внутри блока using; это гарантирует освобождение всех внутренних ресурсов при выходе из блока.

Пример форматирования текста

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

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Bold heading in corporate blue");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 28;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);
prs.Save("formatted.pptx", SaveFormat.Pptx);

Текущие ограничения

В этом выпуске следующие области не поддерживаются:

  • Диаграммы, SmartArt и OLE‑объекты
  • Анимации и переходы слайдов
  • Экспорт в PDF, HTML, SVG или графические форматы
  • Гиперссылки, настройки действий, макросы VBA и цифровые подписи

Неизвестные XML‑части, обнаруженные при загрузке, сохраняются дословно при сохранении, поэтому PPTX‑файлы, созданные другими инструментами, безопасно проходят цикл загрузки‑сохранения.

См. также