Gestion des propriétés du document

Introduction

Microsoft Excel offre la possibilité d’ajouter des propriétés aux fichiers de feuille de calcul. Ces propriétés de document fournissent des informations utiles et sont divisées en 2 catégories comme détaillé ci-dessous.

  • Propriétés définies par le système (intégré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.
  • Propriétés définies par l’utilisateur (personnalisées) : propriétés personnalisées définies par l’utilisateur final sous la forme d’une paire nom-valeur.

Gestion des propriétés du document à l’aide de Microsoft Excel

Microsoft Excel permet de gérer les propriétés de document des fichiers Excel de manière WYSIWYG. Veuillez suivre les étapes ci-dessous pour ouvrir lePropriétés boîte de dialogue dans Excel 2016.

  1. DuDossier menu, sélectionnezInfo.
Sélection du menu d’informations
tâche : image_autre_texte
  1. Cliquer surPropriétésrubrique et sélectionnez “Propriétés avancées”.
Cliquer sur la sélection des propriétés avancées
tâche : image_autre_texte
  1. Gérer les propriétés de document du fichier.
Boîte de dialogue Propriétés
tâche : image_autre_texte
Dans la boîte de dialogue Propriétés, il existe différents onglets, tels que Général, Résumé, Statistiques, Contenu et Personnalisés. Chaque onglet permet de configurer différents types d’informations relatives au fichier. L’onglet Personnalisé est utilisé pour gérer les propriétés personnalisées.

Utilisation des propriétés du document à l’aide de Aspose.Cells

Les développeurs peuvent gérer dynamiquement les propriétés du document à l’aide des API Aspose.Cells. Cette fonctionnalité aide les développeurs à stocker des informations utiles avec le fichier, telles que la date de réception, le traitement, l’horodatage, etc.

Accéder aux propriétés du document

Aspose.Cells Les API prennent en charge les deux types de propriétés de document, intégrées et personnalisées. Aspose.Cells'Cahier classe représente un fichier Excel et, comme un fichier Excel, laCahier classe peut contenir plusieurs feuilles de calcul, chacune représentée par leFeuille de travail classe alors que la collection de feuilles de calcul est représentée par laWorksheetCollectionclasse.

Utilisez leWorksheetCollectionpour accéder aux propriétés du document du fichier comme décrit ci-dessous.

Les deuxWorksheetCollection.BuiltInDocumentProperties etWorksheetCollection.CustomDocumentProperties renvoie une instance deDocumentPropertyCollectionDocumentPropertyCollection . Cette collection contientPropriétéDocumentobjets, chacun représentant une seule propriété de document intégrée ou personnalisée.

C’est à l’exigence de l’application comment accéder à une propriété, c’est-à-dire; en utilisant l’index ou le nom de la propriété de laDocumentPropertyCollectionDocumentPropertyCollectioncomme le montre l’exemple ci-dessous.

LePropriétéDocumentclass permet de récupérer le nom, la valeur et le type de la propriété du document :

Ajout ou suppression de propriétés de document personnalisées

Comme nous l’avons décrit précédemment au début de cette rubrique, les développeurs ne peuvent pas ajouter ou supprimer des propriétés intégrées car ces propriétés sont définies par le système, mais il est possible d’ajouter ou de supprimer des propriétés personnalisées car elles sont définies par l’utilisateur.

Ajout de propriétés personnalisées

Aspose.Cells Les API ont exposé leajouter méthode pour laCustomDocumentPropertyCollectionCustomDocumentPropertyCollectionCustomDocumentPropertyCollectionCustomDocumentPropertyCollection class afin d’ajouter des propriétés personnalisées à la collection. Leajouter ajoute la propriété au fichier Excel et renvoie une référence pour la nouvelle propriété de document en tant quePropriétéDocumentobjet.

Configuration de la propriété personnalisée “Lien vers le contenu”

Pour créer une propriété personnalisée liée au contenu d’une plage donnée, appelez leCustomDocumentPropertyCollection.addLinkToContent méthode et transmettez le nom et la source de la propriété. Vous pouvez vérifier si une propriété est configurée comme étant liée au contenu à l’aide de laDocumentProperty.isLinkedToContent la propriété. De plus, il est également possible d’obtenir la plage source à l’aide de laSource propriété de laPropriétéDocumentclasse.

Nous utilisons un simple fichier Excel modèle Microsoft dans l’exemple. Le classeur a une plage nommée définie étiquetéeMaPlage qui fait référence à une valeur de cellule.

Suppression des propriétés personnalisées

Pour supprimer les propriétés personnalisées à l’aide de Aspose.Cells, appelez leDocumentPropertyCollection.removeDocumentPropertyCollection.remove et transmettez le nom de la propriété de document à supprimer.