Gérer les 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.

Le point le plus important à savoir sur les propriétés intégrées et personnalisées est que les propriétés intégrées peuvent être consultées et modifiées, mais pas créées ou supprimées. Cependant, des propriétés personnalisées peuvent être créées et gérées.

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

Microsoft Excel vous 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.

DuDossier menu, sélectionnezInfo.

Sélection du menu d’informations

Cliquer surPropriétésrubrique et sélectionnez “Propriétés avancées”.

Cliquer sur la sélection des propriétés avancées

Gérer les propriétés de document du fichier.

Boîte de dialogue Propriétés

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.

Aspose.Cells for .NET écrit directement les informations sur API et le numéro de version dans les documents de sortie. Par exemple, lors du rendu du document à PDF, Aspose.Cells for .NET remplitApplication champ avec la valeur ‘Aspose.Cells’ etPDF Producteur champ avec la valeur, par exemple ‘Aspose.Cells v17.9’.

Veuillez noter que vous ne pouvez pas demander au Aspose.Cells for .NET de modifier ou de supprimer ces informations des documents de sortie.

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.

Pour accéder aux propriétés de document intégrées, utilisezWorksheetCollection.BuiltInDocumentProperties.
Pour accéder aux propriétés de document personnalisées, utilisezWorksheetCollection.CustomDocumentProperties.

Les deuxWorksheetCollection.BuiltInDocumentProperties etWorksheetCollection.CustomDocumentProperties renvoie l’instance deAspose.Cells.Properties.DocumentPropertyCollection. Cette collection contientAspose.Cells.Properties.DocumentPropertyobjets, 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.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate a Workbook object
	// Open an Excel file
	Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");

	// Retrieve a list of all custom document properties of the Excel file
	Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;

	// Accessing a custom document property by using the property name
	Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties["ContentTypeId"];
	Console.WriteLine(customProperty1.Name + " " + customProperty1.Value);

	// Accessing the same custom document property by using the property index
	Aspose.Cells.Properties.DocumentProperty customProperty2 = customProperties[0];
	Console.WriteLine(customProperty2.Name + " " + customProperty2.Value);

view raw Examples-CSharp-Files-Utility-AccessingDocumentProperties.cs hosted with ❤ by GitHub

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

Pour obtenir le nom de la propriété, utilisezDocumentProperty.NameDocumentProperty.Name.
Pour obtenir la valeur de la propriété, utilisezDocumentProperty.ValueDocumentProperty.Value. DocumentProperty.ValueDocumentProperty.Valuerenvoie la valeur en tant qu’objet.
Pour obtenir le type de propriété, utilisezDocumentProperty.TypeDocumentProperty.Type . Cela renvoie l’un desType de propriété valeurs d’énumération. Après avoir obtenu le type de propriété, utilisez l’un desDocumentProperty.ToXXX méthodes pour obtenir la valeur du type approprié au lieu d’utiliserDocumentProperty.ValueDocumentProperty.Value . LeDocumentProperty.ToXXXméthodes sont décrites dans le tableau ci-dessous.

LePropriétéDocumentLa classe fournit également un ensemble de méthodes qui renvoient les valeurs d’autres types de données.

Nom de membre	Description	Méthode ToXXX
booléen	Le type de données de la propriété est booléen	ToBool
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
Flotteur	Le type de données de la propriété est Double	Doubler
Nombre	Le type de données de la propriété est Int32	ToInt
Chaîne de caractères	Le type de données de la propriété est String	ToString

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate a Workbook object
	// Open an Excel file
	Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");

	// Retrieve a list of all custom document properties of the Excel file
	Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;

	// Accessing a custom document property
	Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties[0];

	// Storing the value of the document property as an object
	object objectValue = customProperty1.Value;

	// Accessing a custom document property
	Aspose.Cells.Properties.DocumentProperty customProperty2 = customProperties[1];

	// Checking the type of the document property and then storing the value of the
	// document property according to that type
	if (customProperty2.Type == Aspose.Cells.Properties.PropertyType.String)
	{
	string value = customProperty2.Value.ToString();
	Console.WriteLine(customProperty2.Name + " : " + value);
	}

view raw Examples-CSharp-Files-Utility-AccessingValueOfDocumentProperties.cs hosted with ❤ by GitHub

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 La méthode ajoute la propriété au fichier Excel et renvoie une référence pour la nouvelle propriété de document en tant queAspose.Cells.Properties.DocumentPropertyobjet.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate a Workbook object
	// Open an Excel file
	Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");

	// Retrieve a list of all custom document properties of the Excel file
	Aspose.Cells.Properties.CustomDocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;

	// Adding a custom document property to the Excel file
	Aspose.Cells.Properties.DocumentProperty publisher = customProperties.Add("Publisher", "Aspose");

	// Saving resultant spreadsheet
	workbook.Save(dataDir + "out_sample-document-properties.xlsx");

view raw Examples-CSharp-Files-Utility-AddingDocumentProperties.cs hosted with ❤ by GitHub

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 passez le nom de la propriété et la source. Vous pouvez vérifier si une propriété est configurée comme étant liée au contenu à l’aide de laDocumentProperty.IsLinkedToContentDocumentProperty.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.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate an object of Workbook
	// Open an Excel file
	Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");

	// Retrieve a list of all custom document properties of the Excel file
	Aspose.Cells.Properties.CustomDocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;

	// Add link to content.
	customProperties.AddLinkToContent("Owner", "MyRange");

	// Accessing the custom document property by using the property name
	Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties["Owner"];

	// Check whether the property is lined to content
	bool islinkedtocontent = customProperty1.IsLinkedToContent;

	// Get the source for the property
	string source = customProperty1.Source;

	// Save the file
	workbook.Save(dataDir + "out_sample-document-properties.xlsx");

view raw Examples-CSharp-Files-Utility-ConfigureLinktoContentDocumentProperty.cs hosted with ❤ by GitHub

Suppression des propriétés personnalisées

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

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate a Workbook object
	// Open an Excel file
	Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");

	// Retrieve a list of all custom document properties of the Excel file
	Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;

	// Removing a custom document property
	customProperties.Remove("Publisher");

	// Save the file
	workbook.Save(dataDir + "out_sample-document-properties.xlsx");

view raw Examples-CSharp-Files-Utility-RemovingCustomProperties.cs hosted with ❤ by GitHub

Sujets avancés

Imprimer et prévisualiser le classeur Gérer les feuilles de calcul des fichiers Excel Microsoft.