Jak začít s Aspose.Slides FOSS pro .NET

Aspose.Slides.Foss pro .NET je bezplatná knihovna s licencí MIT pro vytváření a úpravu souborů PowerPoint .pptx — není vyžadován Microsoft Office, k dispozici na NuGet.

Průvodce krok za krokem

Krok 1: Nainstalujte balíček

Instalace z NuGet (vyžadováno .NET 9.0 nebo novější):

dotnet add package Aspose.Slides.Foss

Ověřte instalaci sestavením projektu:

dotnet build

Krok 2: Importovat požadované jmenné prostory

Přidejte using direktivy, které potřebujete pro načítání prezentací a ukládání:

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

Krok 3: Vytvořit prezentaci

Vytvořte Presentation bez argumentů, abyste začali s jedním prázdným snímkem. Vždy použijte using k zajištění uvolnění interních zdrojů:

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

Krok 4: Přidat tvar s textem

Použijte slide.Shapes.AddAutoShape() k vložení obdélníku, pak zavolejte AddTextFrame() pro přidání textového obsahu:

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

Krok 5: Použijte výplň a uložte

Nastavte plnou barvu výplně na tvaru před uložením:

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

Časté problémy a opravy

TypeLoadException nebo DllNotFoundException
Ujistěte se, že cílíte na .NET 9.0 nebo novější. Knihovna vyžaduje .NET 9.0+. Aktualizujte svůj
.csproj soubor: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException při volání určitých metod
Některé funkce (grafy, animace, export do PDF) nejsou v tomto vydání podporovány.
Zkontrolujte referenci API pro seznam omezení před použitím pokročilých funkcí.

ObjectDisposedException po bloku using
Nevyužívejte instanci Presentation mimo její blok using.
Přistupujte ke všem snímkům, tvarům a textovým rámcům před tím, než blok using skončí.

Soubor nebyl uložen správně Vždy předávejte hodnotu výčtu SaveFormat do Save(). Přetížení Save(path, SaveFormat.Pptx) zapisuje soubor ve formátu PPTX.

Často kladené otázky

Vyžaduje Aspose.Slides.Foss Microsoft Office?

Ne. Knihovna vytváří a čte soubory .pptx nativně v čistém C# bez závislosti na Microsoft Office, COM automatizaci nebo Windows API.

Které verze .NET jsou podporovány?

.NET 9.0 nebo novější. Knihovna běží na Windows, macOS, Linuxu a v Docker kontejnerech.

Je knihovna zdarma pro komerční použití?

Ano. Je vydáno pod licencí MIT. Můžete jej používat, upravovat a redistribuovat pro jakýkoli účel, včetně komerčních aplikací.

Mohu načíst existující soubor PPTX?

Ano. Předávejte cestu k souboru konstruktoru Presentation:

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

Musím volat Dispose explicitně?

Ano, prostřednictvím příkazu using. Presentation implementuje IDisposable a musí být uvolněn, aby se uvolnily souborové handly a interní zdroje.