Как да създавате презентации в .NET
Aspose.Slides FOSS за .NET ви позволява да създавате PowerPoint презентации изцяло на C# без зависимост от Microsoft Office. Това ръководство показва как да създадете нова презентация, да добавите слайдове и форми, да форматирате текст и да запазите резултата.
Ръководство стъпка по стъпка
Стъпка 1: Инсталирайте пакета
Инсталирайте Aspose.Slides FOSS от NuGet. Необходим е .NET 9.0 или по-нов.
dotnet add package Aspose.Slides.FossПроверете инсталацията:
using Aspose.Slides.Foss;
using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");Не са необходими други системни пакети.
Стъпка 2: Импортиране на необходимите пространства от имена
Добавете необходимите пространства от имена за създаване и запазване на презентации.
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;Всички константи за типове форми се намират в Aspose.Slides.Foss.ShapeType. Всички типове форматиране (FillType, NullableBool) също са в Aspose.Slides.Foss.
Стъпка 3: Създаване на презентация
Използвайте new Presentation() с using изявление. Нова презентация започва с един празен слайд.
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);Важно: Винаги използвайте Presentation с using изявление. Класът реализира IDisposable и ресурсите няма да бъдат освободени правилно без него.
Стъпка 4: Достъп до слайд
Първият слайд е с индекс 0. Празна презентация има точно един слайд.
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);Стъпка 5: Добавяне на форма
Използвайте slide.Shapes.AddAutoShape(), за да добавите AutoShape. Параметрите са (shapeType, x, y, width, height), всички в точки (1 точка = 1/72 инча; стандартният слайд е 720 × 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);Стъпка 6: Запазване на презентацията
Извикайте prs.Save(path, SaveFormat.Pptx) преди обектът да бъде освободен. PPTX е единственият поддържан изходен формат.
prs.Save("result.pptx", SaveFormat.Pptx);Файлът се записва атомарно; ако възникне грешка преди това извикване, не се създава изходен файл.
Пълен работен пример
Следната програма създава презентация от два слайда със заглавна форма на първия слайд и таблица на втория.
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");Общи проблеми и решения
ObjectDisposedException
Използвате обекта Presentation след като блокът using е приключил. Всички операции трябва да се извършат преди обектът да бъде освободен.
Грешка за липсващ namespace за ShapeType
Уверете се, че имате using Aspose.Slides.Foss; в горната част на вашия файл. ShapeType, NullableBool, FillType и други enum са в това пространство от имена.
SaveFormat различно от Pptx
Предаване на всяка стойност SaveFormat, различна от SaveFormat.Pptx, не предизвиква изключение. Параметърът format се игнорира без предупреждение и винаги се генерира PPTX. Винаги използвайте SaveFormat.Pptx, за да бъдете изрични.
Често задавани въпроси
Какъв е размерът по подразбиране на слайда?
Новият Presentation() създава слайдове със стандартен размер 10 × 7,5 инча (720 × 540 точки). Промяната на размера на слайда все още не се поддържа в това издание.
Мога ли да добавя повече от един слайд?
Да. Извикайте prs.Slides.AddEmptySlide(prs.LayoutSlides[0]), за да добавите празен слайд и да го достъпите по индекс:
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];Мога ли да отворя съществуващ файл и да добавя слайдове?
Да:
using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);Какви формати мога да запазя?
Поддържа се само SaveFormat.Pptx. Експортирането в PDF, HTML, SVG или изображения не е налично в това издание.