Вступ

Aspose.Slides FOSS for .NET is now available on NuGet: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx файли повністю на C#, без залежності від Microsoft Office чи будь‑якого пропрієтарного середовища виконання.

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

Key Features

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

Початок роботи

Встановіть з NuGet. .NET 9.0 або новіша версія потрібна.

dotnet add package Aspose.Slides.Foss

Створіть свою першу презентацію з формою та збережіть її:

using Aspose.Slides.Foss;

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 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);

Поточні обмеження

Наступні області піднімають NotImplementedException у цьому випуску:

  • Діаграми, SmartArt та OLE‑об’єкти
  • Анімації та переходи між слайдами
  • Експорт у PDF, HTML, SVG або формати зображень
  • Гіперпосилання, налаштування дій, VBA‑макроси та цифрові підписи

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

Дивіться також