Как создавать презентации в .NET
Aspose.Slides FOSS for .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 пунктов).
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. Вся работа должна быть выполнена до того, как объект будет уничтожен.
Ошибка отсутствующего пространства имён для ShapeType
Убедитесь, что у вас есть using Aspose.Slides.Foss; в начале вашего файла. ShapeType, NullableBool, FillType и другие перечисления находятся в этом пространстве имён.
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 или изображения недоступен в этой версии.