Як розпочати роботу з 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 завершить роботу.

File not saved correctly Always pass a SaveFormat enum value to Save(). The overload Save(path, SaveFormat.Pptx) writes a PPTX-format file.

Поширені запитання

Чи потребує Aspose.Slides.Foss Microsoft Office?

Ні. Бібліотека створює та читає файли .pptx нативно на чистому C# без залежності від Microsoft Office, COM automation або Windows APIs.

Які версії .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 і повинно бути звільнено, щоб вивільнити дескриптори файлів та внутрішні ресурси.