Gérer les propriétés de présentation PowerPoint en C#

Vue d’ensemble

Aspose.Slides pour .NET prend en charge deux types de propriétés de document : Intégrées et Personnalisées. Ces deux types de propriétés peuvent être facilement accessibles et gérées à l’aide de l’API Aspose.Slides pour .NET.

Pour gérer les propriétés de document, Aspose.Slides fournit l’interface IDocumentProperties accessible via la propriété Presentation.DocumentProperties. Les développeurs peuvent exploiter l’interface IDocumentProperties de l’objet Presentation pour lire, modifier et gérer les propriétés de la présentation, comme le montrent les exemples ci‑dessous.

Veuillez noter que les champs Application et Producer ne peuvent pas être modifiés, ces champs afficheront toujours « Aspose Ltd. » et « Aspose.Slides for .NET x.x.x ».

Gérer les propriétés de la présentation

Microsoft PowerPoint propose une fonctionnalité d’ajout de propriétés aux fichiers de présentation. Ces propriétés de document permettent de stocker des informations utiles avec les fichiers. Il existe deux types de propriétés de document :

Propriétés définies par le système (intégrées)
Propriétés définies par l’utilisateur (personnalisées)

Les propriétés Intégrées contiennent des informations générales sur le document, telles que le titre du document, le nom de l’auteur, les statistiques du document, etc.

Les propriétés Personnalisées sont définies par les utilisateurs sous forme de paires Nom/Valeur, où le nom et la valeur sont spécifiés par l’utilisateur.

Avec Aspose.Slides pour .NET, les développeurs peuvent accéder et modifier à la fois les propriétés intégrées et personnalisées.

Microsoft PowerPoint permet aux utilisateurs de gérer les propriétés de document en cliquant sur l’icône Office, puis en sélectionnant Fichier → Infos → Propriétés. Après avoir choisi Propriétés avancées, une boîte de dialogue apparaît où vous pouvez gérer toutes les propriétés du fichier de présentation.

Dans la boîte de dialogue Propriétés, plusieurs onglets sont disponibles, tels que Général, Résumé, Statistiques, Contenu et Personnalisé. Chaque onglet offre des options pour configurer des types d’informations spécifiques liées au fichier PowerPoint. L’onglet Personnalisé sert à gérer les propriétés définies par l’utilisateur.

Accéder aux propriétés intégrées

Ces propriétés, exposées par l’interface IDocumentProperties, comprennent : Creator (Auteur), Description, Keywords, Created (Date de création), Modified (Date de modification), Printed (Date du dernier impression), LastModifiedBy, SharedDoc (indique si le document est partagé entre différents producteurs), PresentationFormat, Subject, Title, etc.

// Instanciez la classe Presentation qui représente un fichier de présentation.
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);

Modifier les propriétés intégrées

Modifier les propriétés intégrées des fichiers de présentation est aussi simple que d’y accéder. Il suffit d’attribuer une chaîne de caractères à la propriété souhaitée, et la valeur sera mise à jour. Dans l’exemple ci‑dessous, nous montrons comment modifier les propriétés de document intégrées d’un fichier de présentation.

// Instancier la classe Presentation qui représente un fichier de présentation.
using Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");

// Obtenir une référence à l'objet de type IDocumentProperties associé à la présentation.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Définir les propriétés intégrées.
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";

// Enregistrer la présentation dans un fichier.
presentation.Save("DocumentProperties_output.pptx", SaveFormat.Pptx);

Ajouter des propriétés personnalisées à la présentation

Les propriétés personnalisées de présentation permettent aux développeurs de stocker des métadonnées supplémentaires ou des informations spécifiques dans un fichier de présentation. Aspose.Slides facilite la création et la gestion de ces propriétés personnalisées de manière programmatique. Les exemples suivants montrent comment ajouter des propriétés personnalisées à vos présentations.

// Instancier la classe Presentation.
using Presentation presentation = new Presentation();

// Obtenir une référence à l'objet de type IDocumentProperties associé à la présentation.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Ajouter des propriétés personnalisées.
documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;

// Enregistrer la présentation dans un fichier.
presentation.Save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);

Accéder et modifier les propriétés personnalisées

Aspose.Slides permet également aux développeurs d’accéder aux propriétés personnalisées existantes et de modifier leurs valeurs facilement. Cette fonctionnalité aide à maintenir des métadonnées précises et prend en charge les mises à jour dynamiques basées sur les entrées utilisateur ou la logique métier. Les exemples ci‑dessous illustrent comment récupérer et mettre à jour les valeurs de propriétés personnalisées au sein d’une présentation.

// Instancier la classe Presentation qui représente un fichier PPTX.
using Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");

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

// Access and modify the custom properties.
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    string propertyName = documentProperties.GetCustomPropertyName(i);
    object propertyValue = documentProperties[propertyName];

    // Afficher le nom et la valeur de la propriété personnalisée.
    Console.WriteLine("Custom property name : " + propertyName);
    Console.WriteLine("Custom property value : " + propertyValue);

    // Modifier la valeur de la propriété personnalisée.
    documentProperties[propertyName] = "New Value " + (i + 1);
}

// Enregistrer la présentation dans un fichier.
presentation.Save("CustomProperties_output.pptx", SaveFormat.Pptx);

Exemple en direct

Essayez l’application en ligne View & Edit PowerPoint Metadata pour voir comment travailler avec les propriétés de document à l’aide de l’API Aspose.Slides :

*FAQ

Comment puis‑je supprimer une propriété intégrée d’une présentation ?

Les propriétés intégrées font partie intégrante de la présentation et ne peuvent pas être supprimées complètement. Cependant, vous pouvez modifier leurs valeurs ou les définir à vide si la propriété le permet.

Que se passe‑t‑il si j’ajoute une propriété personnalisée qui existe déjà ?

Si vous ajoutez une propriété personnalisée déjà existante, sa valeur sera remplacée par la nouvelle. Vous n’avez pas besoin de la supprimer ou de la vérifier au préalable, Aspose.Slides met automatiquement à jour la valeur de la propriété.

Puis‑je accéder aux propriétés de la présentation sans charger complètement la présentation ?

Oui, vous pouvez accéder aux propriétés de la présentation sans la charger entièrement en utilisant la méthode GetPresentationInfo de la classe PresentationFactory. Ensuite, utilisez la méthode ReadDocumentProperties fournie par l’interface IPresentationInfo pour lire les propriétés de façon efficace, en économisant de la mémoire et en améliorant les performances.

Sécurité de la présentation Récupérer et mettre à jour les propriétés d'affichage de la présentation dans .NET