Kaip pradėti naudotis Aspose.Slides FOSS .NET

Aspose.Slides.Foss for .NET yra nemokama, MIT licencijuota biblioteka, skirta kurti ir redaguoti PowerPoint .pptx failus — nereikia Microsoft Office, prieinama per NuGet.

Žingsnis po žingsnio vadovas

Žingsnis 1: Įdiekite paketą

Įdiekite iš NuGet (reikalingas .NET 9.0 arba vėlesnis):

dotnet add package Aspose.Slides.Foss

Patikrinkite įdiegimą sukurdami projektą:

dotnet build

Žingsnis 2: Importuoti reikiamus vardų sritis

Pridėkite reikiamus using direktyvas, skirtas įkelti prezentacijas ir išsaugoti:

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

3 žingsnis: Sukurti prezentaciją

Sukurkite Presentation be argumentų, kad pradėtumėte su viena tuščia skaidre. Visada naudokite using, kad užtikrintumėte vidinių išteklių atlaisvinimą:

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

Žingsnis 4: Pridėti formą su tekstu

Naudokite slide.Shapes.AddAutoShape(), kad įterptumėte stačiakampį, tada iškvieskite AddTextFrame() kad pridėtumėte teksto turinį:

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

Žingsnis 5: Pridėti užpildą ir išsaugoti

Nustatykite vientiso užpildymo spalvą figūrai prieš išsaugant:

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

Dažnos problemos ir sprendimai

TypeLoadException or DllNotFoundException Įsitikinkite, kad taikote .NET 9.0 arba naujesnę versiją. Biblioteka reikalauja .NET 9.0+. Atnaujinkite savo .csproj failą: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException kai kviečiami tam tikri metodai
Kai kurios funkcijos (diagramos, animacijos, PDF eksportas) šioje versijoje nepalaikomos.
Patikrinkite API nuorodą, kad gautumėte apribojimų sąrašą, prieš naudodami išplėstines funkcijas.

ObjectDisposedException po using bloko
Nenaudokite Presentation egzemplioriaus už jo using bloko. Pasiekite visas skaidres, formas ir teksto rėmus prieš using bloko išėjimą.

Failas neišsaugotas teisingai Visada perduokite SaveFormat enum reikšmę į Save(). Perkrauta funkcija Save(path, SaveFormat.Pptx) įrašo PPTX formato failą.

Dažnai užduodami klausimai

Ar Aspose.Slides.Foss reikalauja Microsoft Office?

Ne. Biblioteka natūraliai sukuria ir skaito .pptx failus grynoje C# be jokios priklausomybės nuo Microsoft Office, COM automatizacijos ar Windows API.

Kokios .NET versijos palaikomos?

.NET 9.0 arba vėlesnė. Biblioteka veikia Windows, macOS, Linux ir Docker konteineriuose.

Ar biblioteka yra nemokama komerciniam naudojimui?

Taip. Ji išleista pagal MIT licenciją. Galite naudoti, modifikuoti ir platinti ją bet kokiam tikslui, įskaitant komercines programas.

Ar galiu įkelti esamą PPTX failą?

Taip. Perduokite failo kelią Presentation konstruktoriui:

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

Ar reikia išreikštinai iškviesti Dispose?

Taip, per using pareiškimą. Presentation įgyvendina IDisposable ir turi būti išvalytas, kad atlaisvintų failų rankenėles ir vidinius išteklius.