Verwaltung von Dokumenteigenschaften
Einführung
Microsoft Excel bietet die Möglichkeit, Eigenschaften zu Tabellendateien hinzuzufügen. Diese Dokumenteigenschaften liefern nützliche Informationen und sind in 2 Kategorien unterteilt, wie unten näher beschrieben.
- Systemdefinierte (eingebaute) Eigenschaften: Eingebaute Eigenschaften enthalten allgemeine Informationen zum Dokument wie Dokumententitel, Autorname, Dokumentenstatistiken und so weiter.
- Benutzerdefinierte (benutzerdefinierte) Eigenschaften: Benutzerdefinierte Eigenschaften, die vom Endbenutzer in Form von Schlüssel-Wert-Paar definiert werden.
Verwalten von Dokumenteigenschaften mit Microsoft Excel
Microsoft Excel ermöglicht das Verwalten von Dokumenteigenschaften der Excel-Dateien in einem WYSIWYG-Verfahren. Befolgen Sie bitte die folgenden Schritte, um den Eigenschaften-Dialog in Excel 2016 zu öffnen.
- Wählen Sie im Datei-Menü Info aus.
| Auswahl des Info-Menüs |
|---|
 |
- Klicken Sie auf die Überschrift Eigenschaften und wählen Sie “Erweiterte Eigenschaften” aus.
| Klicken Sie auf die Auswahl der erweiterten Eigenschaften |
|---|
 |
- Verwalten Sie die Dokumenteigenschaften der Datei.
| Eigenschaften Dialog |
|---|
 |
| Im Eigenschaften-Dialog gibt es verschiedene Registerkarten wie Allgemein, Zusammenfassung, Statistiken, Inhalt und Benutzerdefinierte. Jede Registerkarte dient dazu, verschiedene Arten von Informationen im Zusammenhang mit der Datei zu konfigurieren. Die Registerkarte Benutzerdefiniert wird verwendet, um benutzerdefinierte Eigenschaften zu verwalten. |
Arbeiten mit Dokumenteigenschaften mit Aspose.Cells
Entwickler können die Dokumenteigenschaften dynamisch mit den Aspose.Cells APIs verwalten. Diese Funktion hilft den Entwicklern, nützliche Informationen zusammen mit der Datei zu speichern, z. B. wann die Datei empfangen, verarbeitet, zeitgestempelt wurde usw.
Aspose.Cells for Java schreibt die Informationen über API und Versionsnummer direkt in Ausgabedokumente. Beispielsweise füllt Aspose.Cells for Java beim Rendern des Dokuments in PDF das Anwendungs-Feld mit dem Wert ‘Aspose.Cells’ und das PDF-Erstellungs-Feld mit dem Wert, z. B. ‘Aspose.Cells for Java v17.9’.
Bitte beachten Sie, dass Sie Aspose.Cells for Java nicht anweisen können, diese Informationen aus den Ausgabedokumenten zu ändern oder zu entfernen.
Zugriff auf Dokumenteigenschaften
Aspose.Cells APIs unterstützen beide Arten von Dokumenteigenschaften, eingebaute und benutzerdefinierte. Die Klasse Workbook von Aspose.Cells repräsentiert eine Excel-Datei und, wie eine Excel-Datei, kann die Klasse Workbook mehrere Arbeitsblätter enthalten, die jeweils durch die Klasse Worksheet repräsentiert werden, während die Sammlung von Arbeitsblättern durch die Klasse WorksheetCollection repräsentiert wird.
Verwenden Sie WorksheetCollection, um die Dokumenteigenschaften der Datei wie unten beschrieben abzurufen.
- Um auf die integrierten Dokumenteigenschaften zuzugreifen, verwenden Sie WorksheetCollection.BuiltInDocumentProperties.
- Um auf benutzerdefinierte Dokumenteigenschaften zuzugreifen, verwenden Sie WorksheetCollection.CustomDocumentProperties.
Sowohl WorksheetCollection.BuiltInDocumentProperties als auch WorksheetCollection.CustomDocumentProperties geben eine Instanz von DocumentPropertyCollection zurück. Diese Sammlung enthält DocumentProperty Objekte, die jeweils eine einzelne eingebaute oder benutzerdefinierte Dokumenteigenschaft darstellen.
Es liegt an den Anwendungsanforderungen, wie auf eine Eigenschaft zugegriffen wird; durch Verwendung des Indexes oder des Namens der Eigenschaft aus DocumentPropertyCollection, wie im folgenden Beispiel demonstriert.
Die Klasse DocumentProperty erlaubt das Abrufen des Namens, Werts und Typs der Dokumenteigenschaft:
- Um den Eigenschaftsnamen zu erhalten, verwenden Sie DocumentProperty.Name.
- Um den Eigenschaftswert zu erhalten, verwenden Sie DocumentProperty.Value. DocumentProperty.Value gibt den Wert als Object zurück.
- Um den Eigenschaftstyp zu erhalten, verwenden Sie DocumentProperty.Type. Dies gibt einen der PropertyType Aufzählungswerte zurück.
Hinzufügen oder Entfernen benutzerdefinierter Dokumenteigenschaften
Wie wir zu Beginn dieses Themas bereits beschrieben haben, können Entwickler integrierte Eigenschaften nicht hinzufügen oder entfernen, da diese Eigenschaften systemdefiniert sind, es ist jedoch möglich, benutzerdefinierte Eigenschaften hinzuzufügen oder zu entfernen, da diese benutzerdefiniert sind.
Hinzufügen von benutzerdefinierten Eigenschaften
Aspose.Cells APIs haben die Methode add für die Klasse CustomDocumentPropertyCollection freigegeben, um benutzerdefinierte Eigenschaften in die Sammlung hinzuzufügen. Die Methode add fügt die Eigenschaft der Excel-Datei hinzu und gibt eine Referenz auf die neue Dokumenteigenschaft als DocumentProperty Objekt zurück.
Konfigurieren der benutzerdefinierten Eigenschaft ‘Verknüpfen mit Inhalt’
Um eine benutzerdefinierte Eigenschaft zu erstellen, die mit dem Inhalt eines bestimmten Bereichs verknüpft ist, rufen Sie die Methode CustomDocumentPropertyCollection.addLinkToContent auf und übergeben den Eigenschaftsnamen und die Quelle. Sie können über die Eigenschaft DocumentProperty.isLinkedToContent überprüfen, ob eine Eigenschaft als mit dem Inhalt verknüpft konfiguriert ist. Außerdem ist es auch möglich, den Quellbereich unter Verwendung der Eigenschaft Source der Klasse DocumentProperty zu erhalten.
Im Beispiel verwenden wir eine einfache Vorlage einer Microsoft Excel-Datei. Die Arbeitsmappe hat einen definierten benannten Bereich namens MeinBereich, der sich auf einen Zellenwert bezieht.
Entfernen von benutzerdefinierten Eigenschaften
Um benutzerdefinierte Eigenschaften mit Aspose.Cells zu entfernen, rufen Sie die Methode DocumentPropertyCollection.remove auf und übergeben den Namen der zu entfernenden Dokumenteigenschaft.