Como criar apresentações em .NET
Aspose.Slides FOSS for .NET lets you create PowerPoint presentations entirely in C# with no dependency on Microsoft Office. This guide shows how to create a new presentation, add slides and shapes, format text, and save the result.
Guia passo a passo
Passo 1: Instalar o pacote
Instalar Aspose.Slides FOSS a partir de NuGet. .NET 9.0 ou posterior é necessário.
aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.
Verificar a instalação:
using Aspose.Slides.Foss;
using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");Não são necessários outros pacotes de sistema.
Passo 2: Importar os espaços de nomes necessários
Adicionar os espaços de nomes necessários para criar e salvar apresentações.
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;Todas as constantes de tipo-forma vivem em: Aspose.Slides.Foss.ShapeType.Todos os tipos de formatação (FillType, NullableBool) também são considerados como uma das principais causas de Aspose.Slides.Foss.
Passo 3: Faça uma apresentação
Utilização: new Presentation() com um using Uma nova apresentação começa com um slide em branco.
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;
using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);Importante: Usar sempre: Presentation com um using A classe implementa a instrução de IDisposable E os recursos não serão liberados corretamente sem isso.
Passo 4: Acesse um slide
O primeiro slide está no índice 0. Uma apresentação em branco tem exatamente um slides.
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;
using var prs = new Presentation();
var slide = prs.Slides[0]; // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);Passo 5: Adicionar uma forma
Utilização: slide.Shapes.AddAutoShape() Para adicionar um AutoShape. Os parâmetros são: (shapeType, x, y, width, height) todos em pontos (1 ponto = 1/72 polegada; o slide padrão é 720 x 540 pt).
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;
using var prs = new Presentation();
var slide = prs.Slides[0];
// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);
// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
prs.Save("with-shape.pptx", SaveFormat.Pptx);Passo 6: Salve a apresentação
Chama-me . prs.Save(path, SaveFormat.Pptx) PPTX é o único formato de saída suportado.
prs.Save("result.pptx", SaveFormat.Pptx);O arquivo é escrito atomicamente; se um erro ocorrer antes desta chamada, nenhum arquivos de saída são criados.
Exemplo de trabalho completo
O programa a seguir cria uma apresentação de dois slides com um título no primeiro e uma tabela no segundo.
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;
using var prs = new Presentation();
// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);
// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
new double[] { 200.0, 120.0, 120.0 },
new double[] { 40.0, 40.0, 40.0 });
string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
new[] { "North", "$1.2M", "+8%" },
new[] { "South", "$0.9M", "+4%" },
};
for (int col = 0; col < headers.Length; col++)
table.Rows[0][col].TextFrame.Text = headers[col];
for (int row = 0; row < data.Length; row++)
for (int col = 0; col < data[row].Length; col++)
table.Rows[row + 1][col].TextFrame.Text = data[row][col];
prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");Problemas comuns e soluções
ObjectDisposedException
Está a usar o Presentation Objeto após o using O bloco terminou. Todo o trabalho deve acontecer antes que o objeto seja descartado.
Erro de espaço de nomes em falta para: ShapeType
Certifique-se de que tem using Aspose.Slides.Foss; No topo do seu ficheiro. ShapeType, NullableBool, FillType, e outros enums estão neste espaço de nomes.
SaveFormat que não seja: Pptx
Passar qualquer SaveFormat valor diferente do SaveFormat.Pptx não lança uma exceção. O parâmetro de formato é silenciosamente ignorado e PPTX sempre é produzido. Sempre use SaveFormat.Pptx Para ser explícito.
Perguntas Frequentes
Qual é o tamanho padrão da diapositiva?
Um novo Presentation() cria slides com tamanho padrão de 10 x 7,5 polegadas (720 x 540 pontos). O cambio do tamanhos das slide ainda nao e suportado nesta edicao.
Posso adicionar mais de um slide?
Sim, liga. prs.Slides.AddEmptySlide(prs.LayoutSlides[0]) para anexar um slide em branco e aceder a ele por índice:
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];Posso abrir um arquivo existente e adicionar slides?
- Sim , sim .:
using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);Em que formatos posso salvar?
Apenas: SaveFormat.Pptx A exportação para PDF, HTML, SVG ou imagens não está disponível nesta edição.