1. Produtos
  2.   Aspose.Slides
  3.   Aspose.Slides FOSS for .NET

Aspose.Slides FOSS para .NET

Crie, leia e edite apresentações PowerPoint a partir de .NET — gratuito e de código aberto, sem dependência do Office.

Aspose.Slides FOSS for .NET Aspose.Slides FOSS
for .NET

Documentação GitHub

Biblioteca .NET de Código Aberto para Apresentações PowerPoint

Aspose.Slides FOSS para .NET é uma biblioteca pure-C# licenciada sob MIT para trabalhar com arquivos .pptx do PowerPoint. Adicione um único pacote NuGet e comece imediatamente a criar, ler e editar apresentações sem instalar o Microsoft Office ou qualquer runtime proprietário.

A biblioteca expõe uma API de Apresentação construída em torno de Presentation, Slide, Shape, TextFrame, Paragraph e Portion, o modelo conceitual usado pelo próprio PowerPoint. Adicione e remova slides, insira AutoShapes, Tabelas e Conectores, formate texto ao nível de caractere com negrito, itálico, tamanho e cor da fonte, aplique preenchimentos sólidos ou em gradiente e adicione efeitos visuais (sombra, brilho, desfoque, reflexão).

O padrão IDisposable garante a limpeza confiável de recursos: sempre envolva um Presentation em uma instrução using. Partes desconhecidas de XML encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que a ida e volta nunca destrói o conteúdo que a biblioteca ainda não entende. A biblioteca requer .NET 9.0 ou posterior e não possui extensões nativas para compilar. Desenvolvedores que precisam da API empresarial completa com suporte total de produção podem usar Aspose.Slides for .NET junto a esses recursos de código aberto.

API de Apresentação e Slide

  • Criar e abrir PPTX: Crie novas apresentações ou abra arquivos .pptx existentes via new Presentation() ou new Presentation(file).
  • Adicionar e remover slides: Gerencie programaticamente o SlideCollection com AddClone(), AddEmptySlide(), Remove() e RemoveAt().
  • AutoShapes: Insira retângulos, elipses, linhas e outras ShapeType geometrias via AddAutoShape().
  • Tabelas e Conectores: Adicione formas de tabela estruturadas e linhas de conexão entre formas via AddConnector().
  • Notas do apresentador: Leia e escreva notas do apresentador por slide através de NotesSlideManager.
  • Comentários em tópicos: Acesse os tópicos de comentários em nível de slide com GetSlideComments().

Onde Aspose.Slides FOSS pode ser usado

  • Geração de relatórios: Crie decks de slides com marca a partir de fontes de dados sem o Office.
  • Automação de modelo: Preencha modelos PPTX com conteúdo dinâmico em pipelines CI/CD.
  • Content migration: Leia apresentações existentes e reestruture ou reestilize os slides.
  • Backends sem servidor: Processar arquivos PPTX dentro de contêineres Docker ou Azure Functions.
  • Processamento em lote: Aplique alterações de formatação uniformes em grandes bibliotecas de decks de slides.

Formatação de Texto e Efeitos Visuais

  • Formatação de nível de caractere: Aplique negrito, itálico, tamanho de fonte e cor a objetos individuais Portion via PortionFormat.
  • Preenchimentos sólido e gradiente: Defina o preenchimento da forma para uma cor sólida ou gradiente linear de múltiplas paradas usando FillFormat e FillType.
  • Efeitos de sombra e brilho: Aplique sombra externa, brilho, desfoque e reflexão a qualquer forma via EffectFormat.
  • Alinhamento de parágrafo: Defina o alinhamento à esquerda, centralizado, à direita ou justificado por parágrafo usando ParagraphFormat.Alignment.
  • Round-trip safe: Partes desconhecidas de XML são preservadas literalmente ao re‑salvar.

Experiência do desenvolvedor

Aspose.Slides FOSS instala com um único comando dotnet add package Aspose.Slides.Foss. A biblioteca é pura C# sem extensões nativas para compilar e sem pacotes de sistema para instalar.

A API espelha o próprio modelo de objetos do PowerPoint (Presentation, Slide, Shape, TextFrame, Paragraph, Portion), de modo que qualquer pessoa familiarizada com o modelo de objetos do PowerPoint pode usar a biblioteca imediatamente. Ela é licenciada sob MIT, de código aberto no GitHub, e requer .NET 9.0 ou posterior.

Criar uma apresentação e adicionar uma forma

Use uma instrução using para garantir que o Presentation seja sempre descartado e os recursos sejam liberados. AddAutoShape() recebe um enum ShapeType, depois a posição x/y e a largura/altura em pontos. Chame AddTextFrame() para criar a moldura de texto e definir o texto inicial em uma única chamada — não acesse TextFrame antes de chamar AddTextFrame() pois a moldura é nula até ser criada.

dotnet add package Aspose.Slides.Foss

using Aspose.Slides.Foss;

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

// Add a rectangle AutoShape
var shape = slide.Shapes.AddAutoShape(
    ShapeType.Rectangle, 50, 50, 400, 150
);
shape.AddTextFrame("Hello, Aspose.Slides!");

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

Formatar Texto e Aplicar um Efeito de Preenchimento

A formatação de texto funciona no nível Portion — a menor unidade de uma sequência de caracteres. Abra o arquivo salvo, navegue até a primeira parte do primeiro parágrafo e defina as propriedades da fonte diretamente. O preenchimento da forma é independente: defina FillType para Solid e atribua uma cor a SolidFillColor.Color.

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

using var prs = new Presentation("output.pptx");
var shape = (IAutoShape)prs.Slides[0].Shapes[0];
var portion = shape.TextFrame.Paragraphs[0].Portions[0];

// Bold, 18pt, dark-blue text
portion.PortionFormat.FontBold = NullableBool.True;
portion.PortionFormat.FontHeight = 18;
portion.PortionFormat.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 0, 0, 139);

// Solid background fill on the shape
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 240, 248, 255);

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

Perguntas Frequentes

O que é Aspose.Slides FOSS para .NET?

É uma biblioteca pure-C# gratuita, licenciada sob MIT, para criar, ler e editar apresentações .pptx do PowerPoint sem exigir o Microsoft Office.

Quais formatos de arquivo são suportados?

.pptx é o formato de leitura/gravação suportado. Exportar para PDF, HTML, SVG ou imagens não está disponível nesta edição.

Ele requer Microsoft Office ou PowerPoint?

Não. Aspose.Slides FOSS é uma biblioteca pure-C# sem dependência do Microsoft Office, automação COM ou qualquer runtime proprietário.

Como eu o instalo?

Execute dotnet add package Aspose.Slides.Foss. A biblioteca requer .NET 9.0 ou superior. Não há extensões nativas para compilar.

Posso aplicar efeitos visuais como sombra e brilho?

Sim. A biblioteca suporta sombras externas, brilho, desfoque e efeitos de reflexão em qualquer objeto de forma via a API EffectFormat.

O padrão IDisposable é recomendado?

Sim. Sempre envolva um Presentation em uma instrução using (using var prs = new Presentation();) para garantir a limpeza confiável de recursos.

O round-tripping de um PPTX destruirá conteúdo desconhecido?

Não. Partes desconhecidas de XML encontradas durante o carregamento são preservadas literalmente ao salvar, de modo que o conteúdo que a biblioteca ainda não entende nunca se perde.

Onde posso encontrar o código-fonte?

A biblioteca tem licença MIT e está hospedada no GitHub. Relatórios de bugs e pull requests são bem-vindos.

  

Recursos de Suporte e Aprendizado

 Português