Dokumenteigenschaften verwalten

Einführung

Microsoft Excel bietet die Möglichkeit, Tabellenkalkulationsdateien Eigenschaften hinzuzufügen. Diese Dokumenteigenschaften bieten nützliche Informationen und sind wie unten beschrieben in zwei Kategorien unterteilt.

Systemdefinierte (eingebaute) Eigenschaften: Eingebaute Eigenschaften enthalten allgemeine Informationen über das Dokument wie Dokumenttitel, Autorenname, Dokumentstatistiken und so weiter.
Benutzerdefinierte (benutzerdefinierte) Eigenschaften: Benutzerdefinierte Eigenschaften, die vom Endbenutzer in Form von Name-Wert-Paaren definiert werden.

Der wichtigste Punkt, den Sie über integrierte und benutzerdefinierte Eigenschaften wissen sollten, ist, dass auf integrierte Eigenschaften zugegriffen und diese geändert, aber nicht erstellt oder entfernt werden können. Es können jedoch benutzerdefinierte Eigenschaften erstellt und verwaltet werden.

Dokumenteigenschaften mit Microsoft Excel verwalten

Microsoft Mit Excel können Sie die Dokumenteigenschaften der Excel-Dateien WYSIWYG-artig verwalten. Bitte befolgen Sie die nachstehenden Schritte, um die zu öffnenEigenschaften Dialogfeld in Excel 2016.

Von demDatei Menü, auswählenDie Info.

Auswählen des Info-Menüs

Klicke aufEigenschaftenÜberschrift und wählen Sie “Erweiterte Eigenschaften”.

Klicken Sie auf Erweiterte Eigenschaftenauswahl

Verwalten Sie die Dokumenteigenschaften der Datei.

Eigenschaftendialog

Im Eigenschaftendialog gibt es verschiedene Registerkarten wie Allgemein, Zusammenfassung, Statistik, Inhalt und Benutzerdefiniert. Jede Registerkarte hilft bei der Konfiguration verschiedener Arten von Informationen in Bezug auf die Datei. Die Registerkarte Benutzerdefiniert wird verwendet, um benutzerdefinierte Eigenschaften zu verwalten.

Arbeiten mit Dokumenteigenschaften mit Aspose.Cells

Entwickler können die Dokumenteigenschaften mithilfe der Aspose.Cells-APIs dynamisch verwalten. Diese Funktion hilft den Entwicklern, nützliche Informationen zusammen mit der Datei zu speichern, z. B. wann die Datei empfangen, verarbeitet, mit einem Zeitstempel versehen wurde und so weiter.

Aspose.Cells for .NET schreibt die Informationen über API und die Versionsnummer direkt in Ausgabedokumente. Beispielsweise wird beim Rendern von Dokument an PDF Aspose.Cells for .NET ausgefülltAnwendung Feld mit dem Wert ‘Aspose.Cells’ undPDF Hersteller Feld mit dem Wert, zB ‘Aspose.Cells v17.9’.

Bitte beachten Sie, dass Sie Aspose.Cells for .NET nicht anweisen können, diese Informationen aus Ausgabedokumenten zu ändern oder zu entfernen.

Zugriff auf Dokumenteigenschaften

Aspose.Cells APIs unterstützen beide Arten von Dokumenteigenschaften, integrierte und benutzerdefinierte. Aspose.Cells'Arbeitsmappe Klasse stellt eine Excel-Datei dar und wie eine Excel-Datei dieArbeitsmappe Die Klasse kann mehrere Arbeitsblätter enthalten, die jeweils durch dargestellt werdenArbeitsblatt Klasse, während die Sammlung von Arbeitsblättern durch die dargestellt wirdArbeitsblattsammlungKlasse.

Verwenden Sie dieArbeitsblattsammlung, um wie unten beschrieben auf die Dokumenteigenschaften der Datei zuzugreifen.

Um auf integrierte Dokumenteigenschaften zuzugreifen, verwenden SieWorksheetCollection.BuiltInDocumentProperties.
Um auf benutzerdefinierte Dokumenteigenschaften zuzugreifen, verwenden SieWorksheetCollection.CustomDocumentProperties.

BeideWorksheetCollection.BuiltInDocumentProperties undWorksheetCollection.CustomDocumentProperties gibt die Instanz von zurückAspose.Cells.Properties.DocumentPropertyCollection. Diese Sammlung enthältAspose.Cells.Properties.DocumentProperty-Objekte, die jeweils eine einzelne integrierte oder benutzerdefinierte Dokumenteigenschaft darstellen.

Es hängt von der Anwendungsanforderung ab, wie auf eine Eigenschaft zugegriffen wird, das heißt; indem Sie den Index oder Namen der Eigenschaft aus dem verwendenDocumentPropertyCollectionwie im folgenden Beispiel gezeigt.

	// 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

DasAspose.Cells.Properties.DocumentProperty-Klasse ermöglicht es, den Namen, Wert und Typ der Dokumenteigenschaft abzurufen:

Verwenden Sie zum Abrufen des EigenschaftsnamensDokumenteigenschaft.Name.
Um den Eigenschaftswert zu erhalten, verwenden SieDocumentProperty.Value. DocumentProperty.Valuegibt den Wert als Objekt zurück.
Verwenden Sie zum Abrufen des EigenschaftstypsDocumentProperty.Type . Dies gibt eine der zurückArt der Immobilie Aufzählungswerte. Nachdem Sie den Eigenschaftstyp erhalten haben, verwenden Sie eine derDocumentProperty.ToXXX Methoden, um den Wert des entsprechenden Typs zu erhalten, anstatt zu verwendenDocumentProperty.Value . DasDocumentProperty.ToXXXMethoden sind in der folgenden Tabelle beschrieben.

DasDocumentPropertyDie Klasse stellt auch eine Reihe von Methoden bereit, die die Werte anderer Datentypen zurückgeben.

Mitgliedsname	Beschreibung	ToXXX-Methode
Boolesch	Der Eigenschaftsdatentyp ist Boolean	ToBool
Datum	Der Eigenschaftsdatentyp ist DateTime. Beachten Sie, dass Microsoft nur Excel speichert B. dem Datumsteil, kann keine Uhrzeit in einer benutzerdefinierten Eigenschaft dieses Typs gespeichert werden	ToDateTime
Schweben	Der Eigenschaftsdatentyp ist Double	Verdoppeln
Anzahl	Der Eigenschaftsdatentyp ist Int32	ToInt
Schnur	Der Eigenschaftsdatentyp ist 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

Hinzufügen oder Entfernen von benutzerdefinierten Dokumenteigenschaften

Wie wir bereits zu Beginn dieses Themas beschrieben haben, können Entwickler keine integrierten Eigenschaften hinzufügen oder entfernen, da diese Eigenschaften systemdefiniert sind, aber es ist möglich, benutzerdefinierte Eigenschaften hinzuzufügen oder zu entfernen, da diese benutzerdefiniert sind.

Hinzufügen von benutzerdefinierten Eigenschaften

Aspose.Cells APIs haben die ausgesetztAddieren Methode für dieCustomDocumentPropertyCollection -Klasse, um der Sammlung benutzerdefinierte Eigenschaften hinzuzufügen. DasAddieren -Methode fügt die Eigenschaft der Excel-Datei hinzu und gibt einen Verweis auf die neue Dokumenteigenschaft als zurückAspose.Cells.Properties.DocumentPropertyObjekt.

	// 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

Konfigurieren der benutzerdefinierten Eigenschaft „Link zum Inhalt“.

Um eine benutzerdefinierte Eigenschaft zu erstellen, die mit dem Inhalt eines bestimmten Bereichs verknüpft ist, rufen Sie die aufCustomDocumentPropertyCollection.AddLinkToContent -Methode und übergeben Sie den Eigenschaftsnamen und die Quelle. Sie können überprüfen, ob eine Eigenschaft als mit Inhalt verknüpft konfiguriert ist, indem Sie die verwendenDocumentProperty.IsLinkedToContent Eigentum. Darüber hinaus ist es auch möglich, den Quellbereich mithilfe von abzurufenQuelle Eigentum derDocumentPropertyKlasse.

Wir verwenden im Beispiel eine einfache Vorlage Microsoft Excel-Datei. Die Arbeitsmappe hat einen definierten benannten Bereich mit der BezeichnungMeineRange was sich auf einen Zellenwert bezieht.

	// 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

Benutzerdefinierte Eigenschaften entfernen

Um benutzerdefinierte Eigenschaften mit Aspose.Cells zu entfernen, rufen Sie die anDocumentPropertyCollection.Entfernen-Methode und übergeben Sie den Namen der zu entfernenden Dokumenteigenschaft.

	// 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

Themen vorantreiben

Arbeitsmappe drucken und in der Vorschau anzeigen Verwalten Sie Arbeitsblätter von Microsoft Excel-Dateien.