Свойства документа в PowerPoint C#

Свойства документа или метаданные в файлах PowerPoint используются для идентификации презентаций. Кроме того, они предоставляют дополнительную информацию о презентации, такую как автор, заголовок, ключевые слова, тема и т. д. В этой статье вы узнаете, как получить доступ к свойствам файлов PowerPoint или изменить их программно с помощью C#.

.NET API для доступа/изменения свойств в файлах PowerPoint

Чтобы получить доступ к встроенным или пользовательским свойствам документа или изменить их, мы будем использовать Aspose.Slides for .NET. Это мощный API для создания и управления документами PowerPoint и OpenOffice. API доступен в виде загружаемой DLL, а также в NuGet.

PM> Install-Package Aspose.Slides.NET

Типы свойств в презентациях PowerPoint

Презентации PowerPoint поддерживают два типа свойств документа: встроенные и настраиваемые. Встроенные свойства предоставляют общую информацию о презентациях, такую как название, автор, тема и т. д. Принимая во внимание, что настраиваемые свойства определяются пользователями в виде пар ключ/значение. В следующих разделах показано, как добавлять, получать доступ и изменять свойства, принадлежащие каждому из вышеупомянутых типов.

Доступ к встроенным свойствам в презентациях PowerPoint с помощью C#

Ниже приведены шаги для доступа к встроенным свойствам в презентациях PowerPoint с помощью C#.

  • Загрузите презентацию PowerPoint, используя класс Presentation.
  • Получите доступ к встроенным свойствам объекта IDocumentProperties из свойства Presentation.DocumentProperties.
  • Считайте каждое встроенное свойство в презентации с помощью объекта IDocumentProperties, например IDocumentProperties.Author.

В следующем примере кода показано, как получить доступ к встроенным свойствам в презентациях PowerPoint.

// Загрузить презентацию
Presentation pres = new Presentation("AccessBuiltin Properties.pptx");

// Создайте ссылку на объект IDocumentProperties, связанный с презентацией.
IDocumentProperties documentProperties = pres.DocumentProperties;

// Показать встроенные свойства
System.Console.WriteLine("Category : " + documentProperties.Category);
System.Console.WriteLine("Current Status : " + documentProperties.ContentStatus);
System.Console.WriteLine("Creation Date : " + documentProperties.CreatedTime);
System.Console.WriteLine("Author : " + documentProperties.Author);
System.Console.WriteLine("Description : " + documentProperties.Comments);
System.Console.WriteLine("KeyWords : " + documentProperties.Keywords);
System.Console.WriteLine("Last Modified By : " + documentProperties.LastSavedBy);
System.Console.WriteLine("Supervisor : " + documentProperties.Manager);
System.Console.WriteLine("Modified Date : " + documentProperties.LastSavedTime);
System.Console.WriteLine("Presentation Format : " + documentProperties.PresentationFormat);
System.Console.WriteLine("Last Print Date : " + documentProperties.LastPrinted);
System.Console.WriteLine("Is Shared between producers : " + documentProperties.SharedDoc);
System.Console.WriteLine("Subject : " + documentProperties.Subject);
System.Console.WriteLine("Title : " + documentProperties.Title);

Изменение встроенных свойств в презентациях PowerPoint с помощью C#

Ниже приведены шаги по изменению значений встроенных свойств в презентациях PowerPoint с помощью C#.

В следующем примере кода показано, как изменить встроенные свойства в презентациях PowerPoint.

// Загрузить презентацию
Presentation presentation = new Presentation("ModifyBuiltinProperties.pptx");

// Создайте ссылку на объект IDocumentProperties, связанный с презентацией.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Установите встроенные свойства
documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Modifying Presentation Properties";
documentProperties.Subject = "Aspose Subject";
documentProperties.Comments = "Aspose Description";
documentProperties.Manager = "Aspose Manager";

// Сохраните презентацию в файл
presentation.Save("DocumentProperties_out.pptx", SaveFormat.Pptx);

Добавление пользовательских свойств в презентации PowerPoint с помощью C#

Ниже приведены шаги по добавлению настраиваемых свойств в презентацию PowerPoint с помощью C#.

  • Сначала загрузите презентацию PowerPoint, используя класс Presentation.
  • Затем получите ссылку на свойства документа в объекте IDocumentProperties из свойства Presentation.DocumentProperties.
  • Добавьте пользовательское свойство, определив его ключ и значение, например, IDocumentProperties[“Key”] = “Value”.
  • Наконец, сохраните презентацию с помощью метода Presentation.Save(String, SaveFormat).

В следующем примере кода показано, как добавить настраиваемые свойства в презентацию PowerPoint.

// Загрузить презентацию
Presentation presentation = new Presentation("Presentation.pptx");

// Получить ссылку на свойства документа
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Добавить пользовательские свойства
documentProperties["New Custom"] = 12;
documentProperties["My Name"] = "Mudassir";
documentProperties["Custom"] = 124;

// Сохранить презентацию
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);

Доступ к пользовательским свойствам в презентациях PowerPoint с помощью C#

Следующие шаги демонстрируют, как получить доступ к пользовательским свойствам в презентации PowerPoint с помощью C#.

В следующем примере кода показано, как получить доступ к настраиваемым свойствам в презентации PowerPoint.

// Загрузить презентацию
Presentation presentation = new Presentation("Presentation.pptx");

// Получить ссылку на свойства документа
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Доступ к пользовательским свойствам
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    // Отображение имен и значений пользовательских свойств
    System.Console.WriteLine("Custom Property Name : " + documentProperties.GetCustomPropertyName(i));
    System.Console.WriteLine("Custom Property Value : " + documentProperties[documentProperties.GetCustomPropertyName(i)]);
}

Изменение пользовательских свойств в презентациях PowerPoint с помощью C#

Ниже приведены шаги по изменению настраиваемых свойств в презентации PowerPoint.

  • Сначала загрузите презентацию PowerPoint, используя класс Presentation.
  • Затем получите ссылку на свойства документа в объекте IDocumentProperties из свойства Presentation.DocumentProperties.
  • Получите доступ к каждому пользовательскому свойству с помощью метода IDocumentProperties.GetCustomPropertyName(int32 index) в цикле.
  • Измените значение свойства, указав его ключ в массиве IDocumentProperties[IDocumentProperties.GetCustomPropertyName(int index)].
  • Наконец, сохраните презентацию, используя метод Presentation.Save(String, SaveFormat).

В следующем примере кода показано, как изменить пользовательское свойство в презентации PowerPoint.

// Загрузить презентацию
Presentation presentation = new Presentation("Presentation.pptx");

// Получить ссылку на свойства документа
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Доступ и изменение пользовательских свойств
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    // Изменить значения пользовательских свойств
    documentProperties[documentProperties.GetCustomPropertyName(i)] = "New Value " + (i + 1);
}

// Сохранить презентацию
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);

Получите бесплатную лицензию API

Вы можете использовать Aspose.Slides для .NET без ограничений на пробную версию, запросив временную лицензию.

Онлайн-демонстрация

Вы также можете попробовать онлайн-инструмент для просмотра и редактирования свойств документа в презентациях, который основан на Aspose.Slides.

Вы также можете попробовать Aspose бесплатный онлайн-редактор PowerPoint.

Вывод

В этой статье вы узнали, как добавлять, получать доступ и изменять свойства документа в презентациях PowerPoint с помощью C#. В статье подробно описано манипулирование встроенными и пользовательскими свойствами документа. Кроме того, вы можете посетить документацию, чтобы узнать больше об Aspose.Slides для .NET. Кроме того, вы можете размещать свои вопросы на нашем форуме.

Смотрите также