Comment démarrer avec Aspose.Slides FOSS pour .NET

Aspose.Slides.Foss pour .NET est une bibliothèque gratuite, sous licence MIT, permettant de créer et de modifier des fichiers PowerPoint .pptx — aucun Microsoft Office requis, disponible sur NuGet.

Guide étape par étape

Étape 1 : Installer le package

Installer depuis NuGet (requiert .NET 9.0 ou version ultérieure) :

dotnet add package Aspose.Slides.Foss

Vérifiez l’installation en construisant le projet :

dotnet build

Étape 2 : Importer les espaces de noms requis

Ajoutez les directives using nécessaires pour charger les présentations et les enregistrer :

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

Étape 3 : Créer une présentation

Construisez un Presentation sans arguments pour commencer avec une diapositive vierge. Utilisez toujours
using pour garantir la libération des ressources internes :

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

Étape 4 : Ajouter une forme avec du texte

Utilisez slide.Shapes.AddAutoShape() pour insérer un rectangle, puis appelez AddTextFrame() pour ajouter du contenu texte :

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

Étape 5 : Appliquer un remplissage et enregistrer

Définissez une couleur de remplissage unie sur la forme avant d’enregistrer :

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

Problèmes courants et solutions

TypeLoadException ou DllNotFoundException
Assurez‑vous de cibler .NET 9.0 ou une version ultérieure. La bibliothèque nécessite .NET 9.0+. Mettez à jour votre
.csproj fichier : <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException lors de l’appel de certaines méthodes
Certaines fonctionnalités (graphiques, animations, exportation PDF) ne sont pas prises en charge dans cette version.
Consultez la référence API pour obtenir une liste des limitations avant d’utiliser des fonctionnalités avancées.

ObjectDisposedException après le bloc using
N’utilisez pas d’instance Presentation en dehors de son bloc using. Accédez à toutes les diapositives,
formes et cadres de texte avant que le bloc using ne se termine.

Fichier non enregistré correctement Toujours passer une valeur d’énumération SaveFormat à Save(). La surcharge Save(path, SaveFormat.Pptx) écrit un fichier au format PPTX.

Questions fréquemment posées

Aspose.Slides.Foss nécessite-t-il Microsoft Office ?

Non. La bibliothèque crée et lit les fichiers .pptx nativement en C# pur sans aucune dépendance à Microsoft Office, à l’automatisation COM ou aux Windows APIs.

Quelles versions de .NET sont prises en charge ?

.NET 9.0 ou version ultérieure. La bibliothèque fonctionne sous Windows, macOS, Linux et les conteneurs Docker.

La bibliothèque est‑elle gratuite pour une utilisation commerciale ?

Oui. Il est publié sous la licence MIT. Vous pouvez l’utiliser, le modifier et le redistribuer pour tout usage, y compris les applications commerciales.

Puis-je charger un fichier PPTX existant ?

Oui. Passez le chemin du fichier au constructeur Presentation :

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

Dois‑je appeler Dispose explicitement ?

Oui, via l’instruction using. Presentation implémente IDisposable et doit être supprimé pour libérer les poignées de fichiers et les ressources internes.