Як завантажити презентації у .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 (бінарний 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}");