Kā sākt darbu ar Aspose.Slides FOSS .NET

Aspose.Slides.Foss for .NET ir bezmaksas, MIT licences bibliotēka PowerPoint .pptx failu izveidei un rediģēšanai — nav vajadzīgs Microsoft Office, pieejama NuGet.

Rokasgrāmata soli pa solim

1. solis: instalējiet pakotni

Instalējiet no NuGet (.NET 9.0 vai jaunāks ir nepieciešams):

dotnet add package Aspose.Slides.Foss

Pārbaudiet instalāciju, veidojot projektu:

dotnet build

2. solis: Importēt nepieciešamās nosaukumtelpas

Pievienojiet vajadzīgās using norādes prezentāciju ielādēšanai un saglabāšanai:

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

3. solis: Izveidot prezentāciju

Izveidojiet Presentation bez argumentiem, lai sāktu ar vienu tukšu slaidu. Vienmēr izmantojiet
using, lai nodrošinātu iekšējo resursu atbrīvošanu:

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

4. solis: Pievienot formu ar tekstu

Izmantojiet slide.Shapes.AddAutoShape(), lai ievietotu taisnstūri, tad izsauciet AddTextFrame()
lai pievienotu teksta saturu:

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

5. solis: pielietot aizpildījumu un saglabāt

Iestatiet vienkrāsainu aizpildījuma krāsu uz formas pirms saglabāšanas:

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

Biežas problēmas un risinājumi

TypeLoadException or DllNotFoundException
Pārliecinieties, ka mērķējat .NET 9.0 vai jaunāku. Bibliotēkai nepieciešams .NET 9.0+. Atjauniniet savu
.csproj failu: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException izsaucot noteiktas metodes
Dažas funkcijas (diagrammas, animācijas, PDF eksportēšana) šajā izlaidumā nav atbalstītas.
Pārbaudiet API atsauci, lai iegūtu ierobežojumu sarakstu, pirms izmantojat papildu funkcijas.

ObjectDisposedException pēc using bloka
Nelietojiet Presentation instanci ārpus tās using bloka.
Piekļūstiet visiem slaidiem,
formām un teksta rāmjiem, pirms using bloka izbeidzas.

Fails nav saglabāts pareizi Vienmēr nododiet SaveFormat enum vērtību uz Save(). Pārslogošana Save(path, SaveFormat.Pptx) raksta PPTX‑formāta failu.

Biežāk uzdotie jautājumi

Vai Aspose.Slides.Foss pieprasa Microsoft Office?

Nē. Bibliotēka izveido un lasa .pptx failus dabiski tīrā C# bez atkarības no Microsoft Office, COM automation vai Windows APIs.

Kādas .NET versijas tiek atbalstītas?

.NET 9.0 vai jaunāks. Bibliotēka darbojas Windows, macOS, Linux un Docker konteineros.

Vai bibliotēka ir bezmaksas komerciālai lietošanai?

Jā. Tas ir izlaists zem MIT licences. Jūs varat izmantot, modificēt un izplatīt to par jebkuru mērķi, ieskaitot komerciālas lietojumprogrammas.

Vai es varu ielādēt esošu PPTX failu?

Jā. Pārsūtiet faila ceļu Presentation konstruktoram:

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

Vai man jāizsauc Dispose eksplicīti?

Jā, izmantojot using paziņojumu. Presentation īsteno IDisposable un jāizmet, lai atbrīvotu failu rokturus un iekšējos resursus.