Manage Presentation Properties in .NET
Introduction
Aspose.Slides for .NET supports built-in and custom document properties. Use these properties to read and update presentation metadata, such as the author, title, and user-defined values.
Aspose.Slides allows you to work with presentation document properties through the IDocumentProperties interface. An instance of this interface is returned by IPresentation.DocumentProperties. The following examples show how to read, modify, and manage these properties.
Note
Aspose.Slides manages the application and producer metadata when saving presentations; these fields identify the software that created the output.Manage Presentation Properties
Document properties store descriptive information alongside presentation content. They fall into two categories:
- Built-in properties contain standard metadata, such as the title, author, and document statistics.
- Custom properties store user-defined name/value pairs.
Aspose.Slides for .NET provides access to both categories. In PowerPoint, select File → Info → Properties → Advanced Properties to inspect document metadata. The dialog groups information into tabs such as Summary, Statistics, Contents, and Custom. Use the Custom tab to manage user-defined properties.
Read Public Properties from an Encrypted Presentation
An opening password normally protects both presentation content and document properties. When a presentation is encrypted with IProtectionManager.EncryptDocumentProperties set to false, its document properties remain public. An application can then set LoadOptions.OnlyLoadDocumentProperties to true and read the public metadata without supplying the opening password.
LoadOptions.OnlyLoadDocumentProperties controls what Aspose.Slides loads; it does not decrypt anything. If the properties were included in encryption, loading them without the password fails. If the presentation is not encrypted, the option is ignored and the complete presentation is loaded.
The example requires an encrypted presentation whose document properties were left public. It verifies the loading mode through IProtectionManager.IsOnlyDocumentPropertiesLoaded and then reads built-in properties through IPresentation.DocumentProperties:
using System;
using Aspose.Slides;
var loadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);
if (presentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
var documentProperties = presentation.DocumentProperties;
Console.WriteLine("Author: " + documentProperties.Author);
Console.WriteLine("Title: " + documentProperties.Title);
Console.WriteLine("Keywords: " + documentProperties.Keywords);
}
else
{
Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}
In this mode, slide content is not loaded. Slides, masters, layouts, shapes, media, and other presentation objects are unavailable. Applications should always check IProtectionManager.IsOnlyDocumentPropertiesLoaded before performing an operation that requires the complete presentation object model.
Security
Public metadata may expose author names, titles, subjects, keywords, company information, comments, and custom values. Encrypt sensitive properties together with the presentation. Leave them public only when indexing, classification, search, or document-management systems have a specific requirement to access them without a password.Update Properties of an Encrypted Presentation
For an encrypted PPTX file, a presentation loaded with LoadOptions.OnlyLoadDocumentProperties is intended for reading public metadata. Aspose.Slides cannot save changed properties from that metadata-only object because the public properties must remain consistent with the corresponding data inside the encrypted presentation. Updating them therefore requires the correct opening password and a complete load.
The example requires an encrypted PPTX presentation with public document properties and a known opening password. It opens the complete presentation with LoadOptions.Password, updates public built-in properties, and saves the result. It then uses IPresentationInfo.IsEncrypted to verify that encryption is preserved and reopens the public metadata without a password to verify the new values:
using System;
using Aspose.Slides;
using Aspose.Slides.Export;
const string inputPath = "public-properties-encrypted.pptx";
const string outputPath = "updated-public-properties-encrypted.pptx";
var loadOptions = new LoadOptions { Password = "open_password" };
using var presentation = new Presentation(inputPath, loadOptions);
var documentProperties = presentation.DocumentProperties;
documentProperties.Title = "Updated Product Roadmap";
documentProperties.Keywords = "roadmap, planning, indexed";
presentation.Save(outputPath, SaveFormat.Pptx);
var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(outputPath);
Console.WriteLine("The presentation is encrypted: " + presentationInfo.IsEncrypted);
var metadataLoadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var metadataPresentation = new Presentation(outputPath, metadataLoadOptions);
if (metadataPresentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
Console.WriteLine("Title: " + metadataPresentation.DocumentProperties.Title);
Console.WriteLine("Keywords: " + metadataPresentation.DocumentProperties.Keywords);
}
else
{
Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}
If an application is not allowed to decrypt or load the presentation content, it must treat public properties of an encrypted PPTX file as read-only.
Access Built-in Properties
The IDocumentProperties interface exposes built-in metadata through typed properties, including Author, Title, and CreatedTime. This example opens an existing presentation and prints its stored metadata to the console. Values depend on the input presentation; some fields may be empty.
using System;
using Aspose.Slides;
using var presentation = new Presentation("AccessBuiltInProperties.pptx");
var documentProperties = presentation.DocumentProperties;
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("Keywords: " + 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);
Modify Built-in Properties
To update built-in metadata, assign values to the writable properties exposed by IPresentation.DocumentProperties. This example opens an existing presentation, sets Author, Title, Subject, Comments, and Manager, then saves the updated presentation with Presentation.Save. The saved PPTX contains the new metadata.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("ModifyBuiltInProperties.pptx");
var 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);
Manage the Hyperlink Base
IDocumentProperties.HyperlinkBase stores the document-level base for relative hyperlinks. This is useful when moving a presentation and its linked files to another location. It is separate from an individual hyperlink’s IHyperlink.ExternalUrl: changing the base does not rewrite the stored link addresses or change absolute destinations.
The example requires a presentation containing both a relative link, such as target.html, and an absolute link, such as https://example.org/absolute.html. It reads the existing base, assigns a new base address, and saves and reopens the presentation to check the value. It then clears the base with string.Empty and verifies the empty value in a separate saved file. Replace the example base address with the location of your linked files.
using System;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("hyperlinks.pptx");
Console.WriteLine("Original base: " + presentation.DocumentProperties.HyperlinkBase);
const string newBase = "https://example.com/new/";
presentation.DocumentProperties.HyperlinkBase = newBase;
presentation.Save("hyperlinks-updated.pptx", SaveFormat.Pptx);
using var updatedPresentation = new Presentation("hyperlinks-updated.pptx");
Console.WriteLine("Base preserved: " + (updatedPresentation.DocumentProperties.HyperlinkBase == newBase));
updatedPresentation.DocumentProperties.HyperlinkBase = string.Empty;
updatedPresentation.Save("hyperlinks-cleared.pptx", SaveFormat.Pptx);
using var clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
Console.WriteLine("Base cleared: " + (clearedPresentation.DocumentProperties.HyperlinkBase == string.Empty));
The two verification messages should print True. Clearing the base leaves the individual hyperlink addresses intact.
A relative link to target.pptx opened old/target.pptx when the base pointed to the old folder. After changing the base to the new folder, saving, and reopening the presentation, the same link opened new/target.pptx. An absolute link continued to open the same file. Test your relative links in PowerPoint before and after moving the presentation or changing its base.
Add Custom Presentation Properties
Custom properties store metadata that has no corresponding built-in field. The IDocumentProperties indexer lets you assign a value by property name. This example creates a presentation, adds two text values and an integer version value, and saves the presentation with Presentation.Save. Assigning a value to an existing name replaces that property’s value.
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation();
var documentProperties = presentation.DocumentProperties;
documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;
presentation.Save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);
Access and Modify Custom Properties
This example opens a presentation containing custom properties and uses CountOfCustomProperties to iterate over them. GetCustomPropertyName accepts a zero-based index and returns the name used by the IDocumentProperties indexer. The example prints each original name and value, replaces every value with a numbered string regardless of its original type, and saves the changes. If there are no custom properties, the loop makes no changes.
using System;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("AccessAndModifyProperties.pptx");
var documentProperties = presentation.DocumentProperties;
for (var i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
var propertyName = documentProperties.GetCustomPropertyName(i);
var 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);
Live Example
Try the View & Edit PowerPoint Metadata online app to see how to work with document properties using the Aspose.Slides API:
FAQ
How can I remove a built-in property from a presentation?
Built-in properties are an integral part of the presentation and cannot be removed entirely. However, you can either change their values or set them to empty if allowed by the specific property.
What happens if I add a custom property that already exists?
If you add a custom property that already exists, its existing value will be overwritten with the new one. You do not need to remove or check the property beforehand, as Aspose.Slides automatically updates the property’s value.
Can I access presentation properties without fully loading the presentation?
Yes. Use PresentationFactory.GetPresentationInfo and then IPresentationInfo.ReadDocumentProperties to read stored document metadata without creating a Presentation instance. See Build a Lightweight Presentation Inventory for a complete reporting example and format-specific limitations.
Can I read public properties of an encrypted presentation without its opening password?
Yes. The presentation must have been encrypted with IProtectionManager.EncryptDocumentProperties set to false, and it must be loaded with LoadOptions.OnlyLoadDocumentProperties set to true.
Can I update an encrypted PPTX file in document-properties-only mode?
No. Public and encrypted property data must remain consistent, so updating an encrypted PPTX file requires loading the complete presentation with the correct opening password.
