Como Começar com Aspose.Slides FOSS para .NET

Aspose.Slides.Foss para .NET é uma biblioteca gratuita, licenciada sob MIT, para criar e editar arquivos PowerPoint .pptx — sem necessidade do Microsoft Office, disponível no NuGet.

Guia passo a passo

Etapa 1: Instalar o Pacote

Instale a partir do NuGet (.NET 9.0 ou posterior requerido):

dotnet add package Aspose.Slides.Foss

Verifique a instalação compilando o projeto:

dotnet build

Etapa 2: Importar Namespaces Necessários

Adicione as diretivas using necessárias para carregar apresentações e salvar:

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

Etapa 3: Criar uma Apresentação

Construa um Presentation sem argumentos para iniciar com um slide em branco. Sempre use using para garantir que os recursos internos sejam liberados:

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

Etapa 4: Adicionar uma Forma com Texto

Use slide.Shapes.AddAutoShape() para inserir um retângulo, então chame AddTextFrame() para adicionar conteúdo de texto:

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

Etapa 5: Aplicar um Preenchimento e Salvar

Defina uma cor de preenchimento sólido na forma antes de salvar:

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

Problemas Comuns e Soluções

TypeLoadException ou DllNotFoundException
Certifique‑se de que está direcionando .NET 9.0 ou posterior. A biblioteca requer .NET 9.0+. Atualize seu .csproj arquivo: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException ao chamar certos métodos
Alguns recursos (gráficos, animações, exportação PDF) não são suportados nesta versão.
Consulte a referência da API para obter uma lista de limitações antes de usar recursos avançados.

ObjectDisposedException após o bloco using
Não use uma instância Presentation fora de seu bloco using. Acesse todos os slides, formas e quadros de texto antes que o bloco using termine.

Arquivo não salvo corretamente Sempre passe um valor enum SaveFormat para Save(). A sobrecarga Save(path, SaveFormat.Pptx) escreve um arquivo no formato PPTX.

Perguntas Frequentes

O Aspose.Slides.Foss requer Microsoft Office?

Não. A biblioteca cria e lê arquivos .pptx nativamente em C# puro, sem dependência do Microsoft Office, automação COM ou APIs do Windows.

Quais versões do .NET são suportadas?

.NET 9.0 ou posterior. A biblioteca funciona em Windows, macOS, Linux e contêineres Docker.

A biblioteca é gratuita para uso comercial?

Sim. Ele é lançado sob a Licença MIT. Você pode usar, modificar e redistribuir para qualquer finalidade, incluindo aplicações comerciais.

Posso carregar um arquivo PPTX existente?

Sim. Passe o caminho do arquivo para o construtor Presentation:

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

Preciso chamar Dispose explicitamente?

Sim, via a instrução using. Presentation implementa IDisposable e deve ser descartado para liberar manipuladores de arquivos e recursos internos.