Gérer les propriétés du document

Introduction

Microsoft Excel offre la possibilité d’ajouter des propriétés aux fichiers de feuilles 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.

Comment gérer les propriétés d’un document à l’aide d’Excel Microsoft

Microsoft Excel vous permet de gérer les propriétés 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. DuDéposer menu, sélectionnez Info*.
Sélection du menu Informations
tâche : image_alt_text
  1. Cliquer surPropriétés et sélectionnez “Propriétés avancées”.
Cliquer sur Sélection des propriétés avancées
tâche : image_alt_text
  1. Gérez les propriétés du document du fichier.
Boîte de dialogue Propriétés
tâche : image_alt_text
Dans la boîte de dialogue Propriétés, il existe différents onglets, comme Général, Résumé, Statistiques, Contenu et Douanes. Chaque onglet permet de configurer différents types d’informations liées au fichier. L’onglet Personnalisé est utilisé pour gérer les propriétés personnalisées.

Comment travailler avec les 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 à laquelle le fichier a été reçu, traité, horodaté, etc.

Comment accéder aux propriétés du document

Les API Aspose.Cells prennent en charge les deux types de propriétés de document, intégrées et personnalisées. Aspose.Cells'Cahier d’exercices la classe représente un fichier Excel et, comme un fichier Excel, laCahier d’exercices La 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 leCollection de feuilles de calculclasse.

Utilisez leCollection de feuilles de calculpour accéder aux propriétés du document du fichier comme décrit ci-dessous.

Les deuxWorksheetCollection.BuiltInDocumentProperties etWorksheetCollection.CustomDocumentProperties renvoyer l’instance deAspose.Cells.Properties.DocumentPropertyCollection. Cette collection contientAspose.Cells.Properties.DocumentPropertyobjets, dont chacun représente une seule propriété de document intégrée ou personnalisée.

Il appartient aux exigences de la demande de savoir comment accéder à une propriété, c’est-à-dire ; en utilisant l’index ou le nom de la propriété duDocumentPropertyCollectioncomme le démontre l’exemple ci-dessous.

LeAspose.Cells.Properties.DocumentPropertyLa classe permet de récupérer le nom, la valeur et le type de la propriété du document :

Nom de membre Description Méthode ToXXX
Booléen Le type de données de la propriété est booléen ÀBool
Date Le type de données de la propriété est DateTime. Notez que Microsoft Excel stocke uniquement
la partie date, aucune heure ne peut être stockée dans une propriété personnalisée de ce type
ÀDateHeure
Flotter Le type de données de la propriété est Double Doubler
Nombre Le type de données de la propriété est Int32 VersInt
String Le type de données de la propriété est String VersChaîne

Comment ajouter ou supprimer des 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 de 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 celles-ci sont définies par l’utilisateur.

Comment ajouter des propriétés personnalisées

Aspose.Cells Les API ont exposé leAjouter méthode pour leCustomDocumentPropertyCollection classe afin d’ajouter des propriétés personnalisées à la collection. LeAjouter La méthode ajoute la propriété au fichier Excel et renvoie une référence pour la nouvelle propriété du document en tant queAspose.Cells.Properties.DocumentPropertyobjet.

Comment configurer 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 la commandeCustomDocumentPropertyCollection.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 liée au contenu à l’aide de l’outilDocumentProperty.IsLinkedToContent propriété. De plus, il est également possible d’obtenir la plage source en utilisant leSource propriété duPropriété du documentclasse.

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

Comment supprimer les propriétés personnalisées

Pour supprimer des propriétés personnalisées à l’aide du Aspose.Cells, appelez leDocumentPropertyCollection.Removeet transmettez le nom de la propriété du document à supprimer.

Sujets avancés