Com començar amb FOSS per a .NET

Aspose.Slides.Foss per .NET és una biblioteca lliure, amb llicència MIT per crear i editar PowerPoint .pptx arxius no es requereix Microsoft Office, disponible a NuGet.

Guia pas a pas

Pas 1: Instal·lar el paquet

Instal·lar des de NuGet (.NET 9.0 o més recent requerit):

dotnet add package Aspose.Slides.Foss

Verifica la instal·lació mitjançant la construcció del projecte:

dotnet build

Pas 2: Importació dels espais de noms requerits

Afegir les directives d’ús que necessites per carregar presentacions i guardar:

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

Pas 3: Crea una presentació

Construir un Presentation Sempre utilitzeu el nom de l’empresa. using per assegurar que es liberin recursos interns:

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: Agregar una forma amb text

Utilització: slide.Shapes.AddAutoShape() per inserir un rectangle, després cridar 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: Aplicar un rellotge i guardar

Ajustar un color de rellotge sòlid a la forma abans d’estalviar:

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 i solucions comuns

TypeLoadException o de la seva DllNotFoundException Assegureu-vos que estàs dirigit a .NET 9.0 o posterior. La biblioteca requereix .Net 9.0.+ Actualitza el teu sistema de programació i instal·lacions per al programari d’accés. .csproj Arxiu: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException quan es crida a determinats mètodes Algunes característiques (diagrames, animacions, exportació PDF) no són suportades en aquesta versió. Consulteu la referència de l’API per a una llista de limitacions abans d’utilitzar característiques avançades.

ObjectDisposedException després de la using bloqueig No utilitzar un Presentation instància fora de la seva using Accedeix a totes les diapositives, les formes, i els marcs de text abans del using bloquejar les sortides.

No s’ha salvat correctament el fitxer Sempre passem un SaveFormat valor enum a Save().La sobrecarrega. Save(path, SaveFormat.Pptx) escriu un fitxer en format PPTX.

Preguntas freqüents

És necessari Microsoft Office?

No, la biblioteca crea i llegeix. .pptx arxius nativament en C# pur sense dependències. en Microsoft Office, l’automatització COM o les API de Windows.

Quines versions .NET són compatibles?

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

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

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

Puc carregar un fitxer PPTX existent?

Passa el camí del fitxer al Presentation constructor:

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

He de trucar a Dispose explícitament?

Sí, a través de la using declaració. Presentation instruments de treball IDisposable i ha de ser disposats a alliberar els fitxers i recursos interns.