Come iniziare con Aspose.Slides FOSS per .NET

Aspose.Slides.Foss per .NET è una libreria gratuita, con licenza MIT, per creare e modificare file PowerPoint .pptx — non è necessario Microsoft Office, disponibile su NuGet.

Guida passo-passo

Passo 1: Installa il pacchetto

Installa da NuGet (richiesto .NET 9.0 o versioni successive):

dotnet add package Aspose.Slides.Foss

Verifica l’installazione compilando il progetto:

dotnet build

Passo 2: Importare i namespace richiesti

Aggiungi le direttive using necessarie per caricare le presentazioni e salvarle:

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

Passo 3: Crea una presentazione

Costruisci un Presentation senza argomenti per iniziare con una diapositiva vuota. Usa sempre using per garantire il rilascio delle risorse interne:

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

Passo 4: Aggiungi una Forma con Testo

Usa slide.Shapes.AddAutoShape() per inserire un rettangolo, poi chiama AddTextFrame() per aggiungere contenuto di testo:

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

Passo 5: Applica un riempimento e salva

Imposta un colore di riempimento solido sulla forma prima di salvare:

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

Problemi comuni e soluzioni

TypeLoadException o DllNotFoundException
Assicurati di puntare a .NET 9.0 o versioni successive. La libreria richiede .NET 9.0+. Aggiorna il tuo
.csproj file: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException quando si chiamano determinati metodi
Alcune funzionalità (grafici, animazioni, esportazione PDF) non sono supportate in questa versione.
Controlla il riferimento API per un elenco di limitazioni prima di utilizzare funzionalità avanzate.

ObjectDisposedException dopo il blocco using
Non utilizzare un’istanza Presentation al di fuori del suo blocco using. Accedi a tutte le diapositive, forme e riquadri di testo prima che il blocco using termini.

File not saved correctly Passa sempre un valore enum SaveFormat a Save(). Il sovraccarico Save(path, SaveFormat.Pptx) scrive un file in formato PPTX.

Domande Frequenti

Aspose.Slides.Foss richiede Microsoft Office?

No. La libreria crea e legge i file .pptx nativamente in puro C# senza dipendenze da Microsoft Office, automazione COM o API Windows.

Quali versioni di .NET sono supportate?

.NET 9.0 o versioni successive. La libreria funziona su Windows, macOS, Linux e contenitori Docker.

La libreria è gratuita per uso commerciale?

Sì. È rilasciato sotto la licenza MIT. Puoi usarlo, modificarlo e ridistribuirlo per qualsiasi scopo, incluse le applicazioni commerciali.

Posso caricare un file PPTX esistente?

Sì. Passa il percorso del file al costruttore Presentation:

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

Devo chiamare Dispose esplicitamente?

Sì, tramite l’istruzione using. Presentation implementa IDisposable e deve essere smaltito per rilasciare i handle dei file e le risorse interne.