Как да започнете с 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.

Често задавани въпроси

Изисква ли Aspose.Slides.Foss Microsoft Office?

Не. Библиотеката създава и чете файлове .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 и трябва да бъде изчистен, за да се освободят файлови дескриптори и вътрешни ресурси.