Aspose.Slides FOSS
.NET
Как загружать презентации в .NET

Как загружать презентации в .NET

Aspose.Slides FOSS for .NET позволяет открыть любой файл .pptx, просмотреть его содержимое и либо сохранить его обратно в PPTX, либо извлечь из него данные. Это руководство охватывает открытие файла, перебор слайдов, чтение текста фигур и обратное сохранение.

Пошаговое руководство

Шаг 1: Установить пакет 

dotnet add package Aspose.Slides.Foss

Шаг 2: Открыть существующую презентацию

Передайте путь к файлу в new Presentation(). Используйте оператор using для обеспечения очистки.

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

using var prs = new Presentation("input.pptx");
Console.WriteLine($"Slide count: {prs.Slides.Count}");
prs.Save("output.pptx", SaveFormat.Pptx);

Неизвестные XML‑части в исходном файле сохраняются дословно: библиотека никогда не удаляет содержимое, которое она ещё не понимает.

Шаг 3: Проверка слайдов

Переберите все слайды и выведите их индекс:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
for (int i = 0; i < prs.Slides.Count; i++)
{
    var slide = prs.Slides[i];
    int shapeCount = slide.Shapes.Count;
    Console.WriteLine($"Slide {i}: {shapeCount} shapes");
}

Шаг 4: Чтение текста формы

Итерировать по фигурам и считывать текст из фигур, имеющих TextFrame:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
foreach (var slide in prs.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IAutoShape autoShape && autoShape.TextFrame != null)
        {
            string text = autoShape.TextFrame.Text;
            if (!string.IsNullOrWhiteSpace(text))
                Console.WriteLine($"  Shape text: {text}");
        }
    }
}

Шаг 5: Чтение свойств документа

Получить основные свойства документа из prs.DocumentProperties:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
var props = prs.DocumentProperties;
Console.WriteLine($"Title:   {props.Title}");
Console.WriteLine($"Author:  {props.Author}");
Console.WriteLine($"Subject: {props.Subject}");

Шаг 6: Сохранение в обратном проходе

После проверки или изменения презентации сохраните её обратно в PPTX:

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

Сохранение в другой путь создаёт новый файл. Сохранение в тот же путь перезаписывает оригинал.

Распространённые проблемы и их решения

FileNotFoundException

Проверьте, что путь к файлу .pptx правильный относительно рабочей директории. Используйте Path.Combine для надёжного построения пути:

string path = Path.Combine(AppContext.BaseDirectory, "assets", "deck.pptx");
using var prs = new Presentation(path);

Exception: File format is not supported

Библиотека поддерживает только .pptx (Office Open XML). Устаревшие .ppt (binary PowerPoint 97-2003) файлы не поддерживаются.

Фигуры не имеют свойства TextFrame

Некоторые фигуры (Connector, PictureFrame) не имеют TextFrame. Приведите к IAutoShape и проверьте на null перед доступом к тексту.

Часто задаваемые вопросы

Сохраняет ли загрузка весь оригинальный контент?

Да. Неизвестные части XML сохраняются дословно при сохранении в режиме round‑trip. Библиотека не будет удалять любой XML‑контент, который она ещё не распознаёт.

Могу ли я загрузить PPTX, защищённый паролем?

Презентации, защищённые паролем (зашифрованные), не поддерживаются в этой версии.

Могу ли я извлечь встроенные изображения?

Получите доступ к коллекции изображений: prs.Images возвращает ImageCollection. У каждого изображения есть свойства для чтения необработанных данных изображения.

Поддерживается ли загрузка из MemoryStream?

Да. Конструктор Presentation принимает Stream:

using var stream = new MemoryStream(pptxBytes);
using var prs = new Presentation(stream);
Console.WriteLine($"Slides: {prs.Slides.Count}");

См. также

 Русский