Como começar com o FOSS para .NET

Aspose.Slides.Foss para .NET é uma biblioteca livre, licenciada pelo MIT para criar e editar PowerPoint .pptx arquivos não é necessário Microsoft Office, disponível no NuGet.

Guia passo a passo

Passo 1: Instalar o pacote

Instalar a partir do NuGet (.NET 9.0 ou posterior necessário):

dotnet add package Aspose.Slides.Foss

Verifique a instalação ao construir o projeto:

dotnet build

Passo 2: Importar espaços de nomes exigidos

Adicione as directivas de uso que você precisa para carregar apresentações e salvar:

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

Passo 3: Faça uma apresentação

Construir um Presentation Sem argumentos para começar com um slide em branco. using Para assegurar a liberação de recursos internos:

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

Passo 4: Adicionar um formato com texto

Utilização: slide.Shapes.AddAutoShape() para inserir um retângulo, em seguida, chamar 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);

Passo 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 a) DllNotFoundException Certifique-se de que você está visando .NET 9.0 ou posterior. A biblioteca requer .Net 9.0.+ Atualizar o seu .csproj Arquivo: <TargetFramework>net9.0</TargetFramework>

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

ObjectDisposedException após o using bloco de Não utilize uma Presentation instância fora de sua using Acesso a todos os slides, O texto é apresentado em quadros de forma e textos antes do using Bloqueia as saídas.

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

Perguntas Frequentes

O Aspose.Slides.Foss requer o Microsoft Office?

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

Quais as versões .NET suportadas?

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

A biblioteca é gratuita para uso comercial?

Sim, é lançado sob a licença MIT. Você pode usá-lo, modificá -lo e redistribuí -la para qualquer finalidade, incluindo aplicações comerciais.

Posso carregar um ficheiro PPTX existente?

Passe o caminho do ficheiro para a página de acesso. Presentation constructor:

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

Preciso de chamar o Dispose explicitamente?

Sim, através do using declaração. Presentation instrumentos de trabalho IDisposable e deve ser Disponibilizar os arquivos e recursos internos.