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. Benutzerdefinierte Dokumenteigenschaften können jedoch erstellt und verwaltet werden.

Dokumenteigenschaften mit Microsoft Excel verwalten

Microsoft Excel ermöglicht die Verwaltung von Dokumenteigenschaften der Excel-Dateien auf WYSIWYG-Weise. Bitte befolgen Sie die nachstehenden Schritte, um die zu öffnenEigenschaften Dialogfeld in Excel 2016.

1. Von demDatei Menü, auswählenDie Info.

Auswählen des Info-Menüs

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

Klicken Sie auf Erweiterte Eigenschaftenauswahl

1. 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 Java schreibt die Informationen über API und die Versionsnummer direkt in Ausgabedokumente. Beispielsweise wird beim Rendern von Dokument an PDF Aspose.Cells for Java ausgefülltAnwendung Feld mit dem Wert ‘Aspose.Cells’ undPDF Hersteller Feld mit dem Wert, zB ‘Aspose.Cells for Java v17.9’.

Bitte beachten Sie, dass Sie Aspose.Cells for Java 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 Sie dieWorksheetCollection.CustomDocumentProperties.

BeideWorksheetCollection.BuiltInDocumentProperties undWorksheetCollection.CustomDocumentProperties gibt eine Instanz von zurückDocumentPropertyCollection . Diese Sammlung enthältDocumentProperty-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-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("ContentTypeId");
 
System.out.println(customProperty1.getName() + " " + customProperty1.getValue());
 
// Accessing a custom document property by using the property index
DocumentProperty customProperty2 = customProperties.get(0);
 
System.out.println(customProperty2.getName() + " " + customProperty2.getValue());

DasDocumentProperty-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 ImmobilieAufzählungswerte.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property
DocumentProperty customProperty1 = customProperties.get(0);
 
// Storing the value of the document property as an object
Object objectValue = customProperty1.getValue();
 
// Accessing a custom document property
DocumentProperty customProperty2 = customProperties.get(1);
 
// Checking the type of the document property and then storing the value of the
// document property according to that type
if (customProperty2.getType() == PropertyType.STRING)
{
  String value = customProperty2.getValue().toString();
}

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 eine Referenz für die neue Dokumenteigenschaft als aDocumentPropertyObjekt.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Adding a custom document property to the Excel file
DocumentProperty publisher = customProperties.add("Publisher", "Aspose");

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-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Add link to content.
customProperties.addLinkToContent("Owner", "MyRange");
 
// Accessing the custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("Owner");
 
// Check whether the property is lined to content
Boolean islinkedtocontent = customProperty1.isLinkedToContent();
 
// Get the source for the property
String source = customProperty1.getSource();

Benutzerdefinierte Eigenschaften entfernen

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

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Removing a custom document property
customProperties.remove("Publisher");