Slik kommer du i gang med Aspose.Slides FOSS for .NET

Aspose.Slides.Foss for .NET er et gratis, MIT‑lisensiert bibliotek for å opprette og redigere PowerPoint .pptx‑filer — ingen Microsoft Office kreves, tilgjengelig på NuGet.

Trinn-for-trinn guide

Steg 1: Installer pakken

Installer fra NuGet (krever .NET 9.0 eller nyere):

dotnet add package Aspose.Slides.Foss

Bekreft installasjonen ved å bygge prosjektet:

dotnet build

Trinn 2: Importer nødvendige navnerom

Legg til de using‑direktivene du trenger for å laste inn presentasjoner og lagre:

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

Steg 3: Opprett en presentasjon

Konstruer en Presentation uten argumenter for å starte med et tomt lysbilde. Bruk alltid using for å sikre at interne ressurser blir frigjøres:

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

Trinn 4: Legg til en form med tekst

Bruk slide.Shapes.AddAutoShape() for å sette inn et rektangel, så kaller du AddTextFrame()
for å legge til tekstinnhold:

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

Trinn 5: Påfør fyll og lagre

Angi en ensfarget fyllfarge på formen før lagring:

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

Vanlige problemer og løsninger

TypeLoadException eller DllNotFoundException
Sørg for at du retter deg mot .NET 9.0 eller nyere. Biblioteket krever .NET 9.0+. Oppdater din
.csproj fil: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException ved å kalle visse metoder
Noen funksjoner (diagrammer, animasjoner, PDF‑eksport) støttes ikke i denne utgivelsen.
Sjekk API‑referansen for en liste over begrensninger før du bruker avanserte funksjoner.

ObjectDisposedException etter using-blokken
Ikke bruk en Presentation-instans utenfor dens using-blokk. Få tilgang til alle lysbilder, former og tekstrammer før using-blokken avsluttes.

Fil ble ikke lagret riktig Pass alltid en SaveFormat enum-verdi til Save(). Overbelastingen Save(path, SaveFormat.Pptx) skriver en PPTX-formatfil.

Ofte stilte spørsmål

Krever Aspose.Slides.Foss Microsoft Office?

Nei. Biblioteket oppretter og leser .pptx‑filer direkte i ren C# uten avhengighet av Microsoft Office, COM‑automatisering eller Windows‑API‑er.

Hvilke .NET‑versjoner støttes?

.NET 9.0 eller nyere. Biblioteket kjører på Windows, macOS, Linux og Docker‑containere.

Er biblioteket gratis for kommersiell bruk?

Ja. Den er utgitt under MIT‑lisensen. Du kan bruke, endre og redistribuere den for ethvert formål, inkludert kommersielle applikasjoner.

Kan jeg laste inn en eksisterende PPTX-fil?

Ja. Send filstien til Presentation-konstruktøren:

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

Må jeg kalle Dispose eksplisitt?

Ja, via using-setningen. Presentation implementerer IDisposable og må bli disponert for å frigjøre filhåndtak og interne ressurser.