Cum să creaţi prezentări în .NET

Cum să creaţi prezentări în .NET

Aspose.Slides FOSS pentru .NET vă permite să creați prezentări PowerPoint în întregime în C# fără nicio dependență de Microsoft Office. Acest ghid arată cum să creați o prezentare nouă, să adăugați diapozitive și forme, să formatați textul și să salvați rezultatul.

Ghid pas cu pas

Pasul 1: Instalați pachetul

Instalați Aspose.Slides FOSS din NuGet. .NET 9.0 sau o versiune ulterioară este necesar.

dotnet add package Aspose.Slides.Foss

Verificați instalarea:

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");

Nu sunt necesare alte pachete de sistem.


Pasul 2: Importați spațiile de nume necesare

Adăugați spațiile de nume necesare pentru crearea și salvarea prezentărilor.

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

Toate constantele de tip formă se află în Aspose.Slides.Foss.ShapeType. Toate tipurile de formatare (FillType, NullableBool) se află, de asemenea, în Aspose.Slides.Foss.


Pasul 3: Creare prezentare

Folosiți new Presentation() cu o declarație using. O nouă prezentare începe cu un slide gol.

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

using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

Important: Folosiți întotdeauna Presentation cu o declarație using. Clasa implementează IDisposable și resursele nu vor fi eliberate corect fără ea.


Pasul 4: Accesarea unui diapozitiv

Primul diapozitiv se află la indexul 0. O prezentare goală are exact un diapozitiv.

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

using var prs = new Presentation();
var slide = prs.Slides[0];  // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);

Pasul 5: Adaugă o formă

Folosiți slide.Shapes.AddAutoShape() pentru a adăuga un AutoShape. Parametrii sunt (shapeType, x, y, width, height) toți în puncte (1 punct = 1/72 inch; diapozitivul standard este 720 x 540 pt).

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

using var prs = new Presentation();
var slide = prs.Slides[0];

// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);

// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("with-shape.pptx", SaveFormat.Pptx);

Pasul 6: Salvați prezentarea

Apelaţi prs.Save(path, SaveFormat.Pptx) înainte ca obiectul să fie eliberat. PPTX este singurul format de ieşire acceptat.

prs.Save("result.pptx", SaveFormat.Pptx);

Fișierul este scris atomic; dacă apare o eroare înainte de acest apel, nu se creează niciun fișier de ieșire.


Exemplu complet funcțional

Programul de mai jos creează o prezentare cu două diapozitive, cu o formă de titlu pe primul diapozitiv și un tabel pe al doilea.

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

using var prs = new Presentation();

// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
    new double[] { 200.0, 120.0, 120.0 },
    new double[] { 40.0, 40.0, 40.0 });

string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
};

for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

for (int row = 0; row < data.Length; row++)
    for (int col = 0; col < data[row].Length; col++)
        table.Rows[row + 1][col].TextFrame.Text = data[row][col];

prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");

Probleme comune și soluții

ObjectDisposedException

Folosiți obiectul Presentation după ce blocul using s-a încheiat. Toate operațiile trebuie să aibă loc înainte ca obiectul să fie eliberat.

Eroare de spațiu de nume lipsă pentru ShapeType

Asigurați-vă că aveți using Aspose.Slides.Foss; în partea de sus a fișierului. ShapeType, NullableBool, FillType și alte enumuri se află în acest spațiu de nume.

SaveFormat altul decât Pptx

Transmiterea oricărei valori SaveFormat diferită de SaveFormat.Pptx nu aruncă o excepție. Parametrul format este ignorat în tăcere și PPTX este întotdeauna generat. Folosiți întotdeauna SaveFormat.Pptx pentru a fi explicit.


Întrebări frecvente

Care este dimensiunea implicită a diapozitivului?

Un nou Presentation() creează diapozitive la dimensiunea standard de 10 x 7,5 inci (720 x 540 puncte). Modificarea dimensiunii diapozitivului nu este încă suportată în această ediție.

Pot adăuga mai mult de un diapozitiv?

Da. Apelaţi prs.Slides.AddEmptySlide(prs.LayoutSlides[0]) pentru a adăuga un diapozitiv gol şi a-l accesa prin index:

prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];

Pot să deschid un fișier existent și să adaug diapozitive?

Da:

using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);

În ce formate pot salva?

Doar SaveFormat.Pptx este acceptat. Exportul în PDF, HTML, SVG sau imagini nu este disponibil în această ediție.


Vezi și

 Română