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) 파일은 지원되지 않습니다.

Shapes에는 TextFrame 속성이 없습니다.

일부 도형(Connector, PictureFrame)에는 TextFrame이 없습니다. IAutoShape로 캐스팅하고 텍스트에 접근하기 전에 null인지 확인하십시오.

자주 묻는 질문

로드가 모든 원본 콘텐츠를 보존합니까?

예. 알 수 없는 XML 파트는 라운드 트립 저장 시 그대로 보존됩니다. 라이브러리는 아직 인식하지 못하는 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}");

참조

 한국어