Dokumenteigenschaften verwalten

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.

Der wichtigste Punkt über eingebaute und benutzerdefinierte Eigenschaften ist, dass auf eingebaute Eigenschaften zugegriffen und geändert, aber nicht erstellt oder entfernt werden kann. Benutzerdefinierte Eigenschaften hingegen können erstellt und verwaltet werden.

So verwalten Sie Dokumenteigenschaften mit Microsoft Excel

Microsoft Excel ermöglicht es Ihnen, die Dokumenteigenschaften der Excel-Dateien auf eine WYSIWYG-Manier zu verwalten. Befolgen Sie bitte die untenstehenden 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.

So arbeiten Sie 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 .NET schreibt direkt die Informationen über API und Versionsnummer in Ausgabedokumente. Zum Beispiel füllt Aspose.Cells for .NET beim Rendern des Dokuments in PDF das Feld Anwendung mit dem Wert ‘Aspose.Cells’ und das Feld PDF-Produzent mit dem Wert, z. B. ‘Aspose.Cells v17.9’.

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

Wie Sie auf Dokumenteigenschaften zugreifen

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 die Instanz von Aspose.Cells.Properties.DocumentPropertyCollection zurück. Diese Sammlung enthält Aspose.Cells.Properties.DocumentProperty Objekte, von denen jedes eine einzelne integrierte oder benutzerdefinierte Dokumenteigenschaft darstellt.

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 Aspose.Cells.Properties.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. Nachdem Sie den Eigenschaftstyp erhalten haben, verwenden Sie eine der DocumentProperty.ToXXX-Methoden, um den Wert des entsprechenden Typs zu erhalten, anstatt DocumentProperty.Value zu verwenden. Die DocumentProperty.ToXXX-Methoden werden in der untenstehenden Tabelle beschrieben.

Die DocumentProperty-Klasse bietet auch eine Reihe von Methoden, die die Werte anderer Datentypen zurückgeben.

Member Name	Beschreibung	ToXXX Methode
Boolean	Der Eigenschaftsdatentyp ist Boolean	ToBool
Date	Der Eigenschaftsdatentyp ist DateTime. Beachten Sie, dass Microsoft Excel nur den Datumsanteil speichert, keine Zeit in einer benutzerdefinierten Eigenschaft dieses Typs gespeichert werden kann	ToDateTime
Float	Der Eigenschaftsdatentyp ist Double	ToDouble
Number	Der Eigenschaftsdatentyp ist Int32	ToInt
String	Der Eigenschaftsdatentyp ist String	ToString

Hinzufügen oder Entfernen von benutzerdefinierten 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 freigelegt, um benutzerdefinierte Eigenschaften zur Sammlung hinzuzufügen. Die Methode Add fügt die Eigenschaft zur Excel-Datei hinzu und gibt eine Referenz für die neue Dokumenteigenschaft als Aspose.Cells.Properties.DocumentProperty-Objekt zurück.

Wie konfiguriert man die benutzerdefinierte Eigenschaft „Verknüpfung zum 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.

Wie entfernt man benutzerdefinierte Eigenschaften

Um benutzerdefinierte Eigenschaften mit Aspose.Cells zu entfernen, rufen Sie die Methode DocumentPropertyCollection.Remove auf und übergeben den Namen der zu entfernenden Dokumenteigenschaft.

Erweiterte Themen

Arbeitsmappe drucken und Vorschau anzeigen Arbeitsblätter von Microsoft Excel Dateien verwalten