.NET에서 프레젠테이션 속성 관리

소개

Aspose.Slides for .NET은 두 종류의 문서 속성을 지원합니다: Built-in 및 Custom. 이러한 속성 유형은 Aspose.Slides for .NET API를 사용하여 쉽게 액세스하고 관리할 수 있습니다.

Aspose.Slides는 IDocumentProperties 인터페이스를 통해 프레젠테이션 문서 속성을 작업할 수 있도록 합니다. 이 인터페이스의 인스턴스는 Presentation.DocumentProperties 속성에서 반환됩니다. 다음 예제에서는 이러한 속성을 읽고, 수정하고, 관리하는 방법을 보여줍니다.

Application 및 Producer 필드는 수정할 수 없으며, 해당 필드는 항상 “Aspose Ltd.” 및 “Aspose.Slides for .NET x.x.x"를 표시합니다.

프레젠테이션 속성 관리

Microsoft PowerPoint는 프레젠테이션 파일에 속성을 추가하는 기능을 제공합니다. 이러한 문서 속성을 사용하면 파일과 함께 유용한 정보를 저장할 수 있습니다. 문서 속성에는 두 종류가 있습니다:

System-defined (built-in) properties
User-defined (custom) properties

Built-in 속성은 문서 제목, 작성자 이름, 문서 통계 등과 같이 문서에 대한 일반 정보를 포함합니다.

Custom 속성은 사용자가 Name/Value 쌍으로 정의하며, 이름과 값 모두 사용자가 지정합니다.

Aspose.Slides for .NET을 사용하면 개발자는 내장 및 맞춤 속성 모두에 액세스하고 수정할 수 있습니다.

Microsoft PowerPoint에서는 Office 아이콘을 클릭한 후 File → Info → Properties를 선택하여 문서 속성을 관리할 수 있습니다. Advanced Properties를 선택하면 프레젠테이션 파일의 모든 문서 속성을 관리할 수 있는 대화 상자가 나타납니다.

Properties 대화 상자에는 General, Summary, Statistics, Contents, Custom과 같은 여러 탭이 있습니다. 각 탭은 PowerPoint 파일과 관련된 특정 유형의 정보를 구성하는 옵션을 제공합니다. Custom 탭은 사용자 정의 속성을 관리하는 데 사용됩니다.

내장 속성 접근

IDocumentProperties 인터페이스를 통해 노출되는 이러한 속성에는 Creator(Author), Description, Keywords, Created(Creation Date), Modified(Modification Date), Printed(Last Print Date), LastModifiedBy, SharedDoc(문서가 여러 제작자 간에 공유되는지 여부), PresentationFormat, Subject, Title 등이 포함됩니다.

// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
using Presentation presentation = new Presentation("AccessBuiltInProperties.pptx");

// Get a reference to the object of type IDocumentProperties associated with the presentation.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Display the Built-in properties.
Console.WriteLine("Category : " + documentProperties.Category);
Console.WriteLine("Content status : " + documentProperties.ContentStatus);
Console.WriteLine("Creation date : " + documentProperties.CreatedTime);
Console.WriteLine("Author : " + documentProperties.Author);
Console.WriteLine("Comments : " + documentProperties.Comments);
Console.WriteLine("Key words : " + documentProperties.Keywords);
Console.WriteLine("Last modified by : " + documentProperties.LastSavedBy);
Console.WriteLine("Manager : " + documentProperties.Manager);
Console.WriteLine("Modified date : " + documentProperties.LastSavedTime);
Console.WriteLine("Presentation format : " + documentProperties.PresentationFormat);
Console.WriteLine("Last print date : " + documentProperties.LastPrinted);
Console.WriteLine("Is shared between producers : " + documentProperties.SharedDoc);
Console.WriteLine("Subject : " + documentProperties.Subject);
Console.WriteLine("Title : " + documentProperties.Title);

내장 속성 수정

프레젠테이션 파일의 내장 속성을 수정하는 것은 접근하는 것만큼 쉽습니다. 원하는 속성에 문자열 값을 할당하면 해당 속성의 값이 업데이트됩니다. 아래 예제에서는 프레젠테이션 파일의 내장 문서 속성을 수정하는 방법을 보여줍니다.

// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
using Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");

// 프레젠테이션과 연결된 IDocumentProperties 타입 객체에 대한 참조를 가져옵니다.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// 내장 속성을 설정합니다.
documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Manage PowerPoint Presentation Properties";
documentProperties.Subject = "Modify Built-in Properties";
documentProperties.Comments = "Aspose description";
documentProperties.Manager = "Aspose manager";

// 프레젠테이션을 파일에 저장합니다.
presentation.Save("DocumentProperties_output.pptx", SaveFormat.Pptx);

맞춤 프레젠테이션 속성 추가

맞춤 프레젠테이션 속성을 사용하면 개발자가 프레젠테이션 파일에 추가 메타데이터나 특정 정보를 저장할 수 있습니다. Aspose.Slides는 이러한 맞춤 속성을 프로그래밍 방식으로 쉽게 생성하고 관리할 수 있도록 합니다. 다음 예제에서는 프레젠테이션에 맞춤 속성을 추가하는 방법을 보여줍니다.

// Presentation 클래스를 인스턴스화합니다.
using Presentation presentation = new Presentation();

// 프레젠테이션과 연결된 IDocumentProperties 타입 객체에 대한 참조를 가져옵니다.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// 맞춤 속성을 추가합니다.
documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;

// 프레젠테이션을 파일에 저장합니다.
presentation.Save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);

맞춤 속성 접근 및 수정

Aspose.Slides는 개발자가 기존 맞춤 속성에 액세스하고 해당 값을 쉽게 수정할 수 있도록 합니다. 이 기능을 사용하면 메타데이터의 정확성을 유지하고 사용자 입력 또는 비즈니스 로직에 따라 동적으로 업데이트할 수 있습니다. 아래 예제는 프레젠테이션 내에서 맞춤 속성 값을 검색하고 업데이트하는 방법을 설명합니다.

// PPTX 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
using Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");

// 프레젠테이션과 연결된 IDocumentProperties 타입 객체에 대한 참조를 가져옵니다.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// 맞춤 속성에 접근하고 수정합니다.
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    string propertyName = documentProperties.GetCustomPropertyName(i);
    object propertyValue = documentProperties[propertyName];

    // 맞춤 속성의 이름과 값을 표시합니다.
    Console.WriteLine("Custom property name : " + propertyName);
    Console.WriteLine("Custom property value : " + propertyValue);

    // 맞춤 속성의 값을 수정합니다.
    documentProperties[propertyName] = "New Value " + (i + 1);
}

// 프레젠테이션을 파일에 저장합니다.
presentation.Save("CustomProperties_output.pptx", SaveFormat.Pptx);

실시간 예제

Aspose.Slides API를 사용하여 문서 속성을 작업하는 방법을 확인하려면 온라인 앱인 View & Edit PowerPoint Metadata를 사용해 보세요:

*FAQ

프레젠테이션에서 내장 속성을 제거하려면 어떻게 해야 하나요?

내장 속성은 프레젠테이션의 필수 구성 요소이므로 완전히 제거할 수 없습니다. 그러나 해당 속성값을 변경하거나, 특정 속성이 허용하는 경우 빈 값으로 설정할 수 있습니다.

이미 존재하는 맞춤 속성을 추가하면 어떻게 되나요?

이미 존재하는 맞춤 속성을 추가하면 기존 값이 새 값으로 덮어쓰여집니다. 속성을 미리 제거하거나 확인할 필요 없이 Aspose.Slides가 자동으로 값을 업데이트합니다.

프레젠테이션을 완전히 로드하지 않고 속성에 액세스할 수 있나요?

예, PresentationFactory 클래스의 GetPresentationInfo 메서드를 사용하면 프레젠테이션을 완전히 로드하지 않고도 속성에 액세스할 수 있습니다. 그런 다음 IPresentationInfo 인터페이스가 제공하는 ReadDocumentProperties 메서드를 활용하여 메모리를 절약하고 성능을 향상시키면서 속성을 효율적으로 읽을 수 있습니다.

.NET에서 보안 프레젠테이션 .NET에서 프레젠테이션 보기 속성 검색 및 업데이트