Ako začať s Aspose.Slides FOSS pre .NET

Aspose.Slides.Foss pre .NET je bezplatná knižnica s licenciou MIT na vytváranie a úpravu súborov PowerPoint .pptx — nie je potrebný Microsoft Office, dostupná na NuGet.

Sprievodca krok za krokom

Krok 1: Nainštalovať balík

Inštalovať z NuGet (vyžaduje sa .NET 9.0 alebo novší):

dotnet add package Aspose.Slides.Foss

Overte inštaláciu zostavením projektu:

dotnet build

Krok 2: Importovať požadované menné priestory

Pridajte using direktívy, ktoré potrebujete na načítanie prezentácií a ich ukladanie:

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

Krok 3: Vytvoriť prezentáciu

Vytvorte Presentation bez argumentov, aby ste začali s jedným prázdnym snímkom. Vždy používajte
using na zabezpečenie uvoľnenia interných zdrojov:

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

Krok 4: Pridať tvar s textom

Použite slide.Shapes.AddAutoShape() na vloženie obdĺžnika, potom zavolajte AddTextFrame() na pridanie textového obsahu:

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

Krok 5: Použiť výplň a uložiť

Nastavte plnú farbu výplne na tvar pred uložením:

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

Bežné problémy a riešenia

TypeLoadException alebo DllNotFoundException
Uistite sa, že cílite .NET 9.0 alebo novší. Knižnica vyžaduje .NET 9.0+. Aktualizujte svoj
.csproj súbor: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException pri volaní určitých metód
Niektoré funkcie (grafy, animácie, export do PDF) nie sú v tomto vydaní podporované.
Skontrolujte referenciu API pre zoznam obmedzení pred použitím pokročilých funkcií.

ObjectDisposedException after the using block Nepožiadajte inštanciu Presentation mimo jej bloku using. Pristúpte ku všetkým snímkam, tvarom a textovým rámikom pred tým, ako blok using skončí.

Súbor nebol uložený správne Vždy odovzdajte hodnotu výčtu SaveFormat do Save(). Preťaženie Save(path, SaveFormat.Pptx) zapisuje súbor vo formáte PPTX.

Často kladené otázky

Vyžaduje Aspose.Slides.Foss Microsoft Office?

Nie. Knižnica vytvára a číta súbory .pptx natívne v čistom C# bez závislosti na Microsoft Office, COM automation alebo Windows APIs.

Ktoré verzie .NET sú podporované?

.NET 9.0 alebo novšia. Knižnica beží na Windows, macOS, Linux a v Docker kontajneroch.

Je knižnica zadarmo pre komerčné použitie?

Áno. Je vydané pod licenciou MIT. Môžete ho používať, upravovať a redistribuovať pre akýkoľvek účel, vrátane komerčných aplikácií.

Môžem načítať existujúci súbor PPTX?

Áno. Zadajte cestu k súboru do konštruktora Presentation:

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

Potrebujem explicitne zavolať Dispose?

Áno, prostredníctvom príkazu using. Presentation implementuje IDisposable a musí byť uvoľnený na uvoľnenie súborových popisovačov a interných zdrojov.