Com començar amb Aspose.Slides FOSS per a .NET

Aspose.Slides.Foss per a .NET és una biblioteca gratuïta, amb llicència MIT, per crear i editar fitxers PowerPoint .pptx — no cal Microsoft Office, disponible a NuGet.

Guia pas a pas

Pas 1: Instal·la el paquet

Instal·la des de NuGet (es requereix .NET 9.0 o posterior):

dotnet add package Aspose.Slides.Foss

Verifiqueu la instal·lació construint el projecte:

dotnet build

Pas 2: Importa els espais de noms necessaris

Afegeix les directives using que necessites per carregar presentacions i desar:

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

Pas 3: Crea una presentació

Construeix un Presentation sense arguments per començar amb una diapositiva en blanc. Utilitza sempre using per assegurar que els recursos interns es alliberen:

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

Pas 4: Afegeix una forma amb text

Utilitzeu slide.Shapes.AddAutoShape() per inserir un rectangle, i després crideu AddTextFrame() per afegir contingut de text:

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

Pas 5: Aplica un farciment i desa

Estableix un color de farciment sòlid a la forma abans de desar:

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

Problemes comuns i solucions

TypeLoadException or DllNotFoundException
Assegureu-vos que esteu dirigint-vos a .NET 9.0 o posterior. La biblioteca requereix .NET 9.0+. Actualitzeu el vostre
.csproj fitxer: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException en cridar determinades mètodes
Algunes funcions (gràfics, animacions, exportació a PDF) no són compatibles en aquesta versió.
Consulteu la referència de l’API per a una llista de limitacions abans d’utilitzar funcions avançades.

ObjectDisposedException després del bloc using
No utilitzeu una instància Presentation fora del seu bloc using. Accediu a totes les diapositives,
formes i marcs de text abans que el bloc using finalitzi.

Fitxer no desat correctament Sempre passa un valor d’enumeració SaveFormat a Save(). La sobrecàrrega Save(path, SaveFormat.Pptx) escriu un fitxer en format PPTX.

Preguntes freqüents

Aspose.Slides.Foss requereix Microsoft Office?

No. La biblioteca crea i llegeix fitxers .pptx de manera nativa en C# pur sense cap dependència de Microsoft Office, automatització COM o APIs de Windows.

Quines versions de .NET són compatibles?

.NET 9.0 o posterior. La biblioteca s’executa a Windows, macOS, Linux i contenidors Docker.

La biblioteca és gratuïta per a ús comercial?

Sí. Es publica sota la Llicència MIT. Podeu utilitzar‑la, modificar‑la i redistribuir‑la per a qualsevol propòsit, incloses les aplicacions comercials.

Puc carregar un fitxer PPTX existent?

Sí. Passeu la ruta del fitxer al constructor Presentation:

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

He d’invocar Dispose explícitament?

Sí, a través de l’enunciat using. Presentation implementa IDisposable i ha de ser alliberat per alliberar els manipuladors de fitxer i els recursos interns.