Arbeiten mit Dokumenteneigenschaften
Dokumenteneigenschaften ermöglichen es, einige nützliche Informationen über Ihr Dokument zu speichern. Diese Eigenschaften können in zwei Gruppen unterteilt werden:
- System oder eingebaut, das Werte wie Dokumenttitel, Autorname, Dokumentstatistik und andere enthält.
- Benutzerdefinierte oder benutzerdefinierte, als Name-Wert-Paare bereitgestellt, wo der Benutzer sowohl den Namen als auch den Wert definieren kann.
Es ist nützlich, diese Informationen über API und Version Nummer wird direkt in Ausgabedokumente geschrieben. Zum Beispiel bei der Umwandlung eines Dokuments in PDF, Aspose.Words füllt das Feld “Anwendung” mit “Aspose.Words”, und das Feld “PDF Produzent” mit “Aspose.Words für Java YY.M.N”, wo YY.M.N ist die Version von Aspose.Words zur Umwandlung verwendet. Für weitere Details siehe Generator oder Vorname In der Ausgabedokumentation enthalten.
Zugriff auf Dokumente Eigenschaften
Zugang zu Dokumenteneigenschaften in Aspose.Words Verwendung:
-
BuiltInDocumentProperties um eingebaute Eigenschaften zu erhalten.
-
CustomDocumentProperties um benutzerdefinierte Eigenschaften zu erhalten.
BuiltInDocumentProperties und CustomDocumentProperties sind Sammlungen von DocumentProperty Objekte. Diese Objekte können durch die Indexer-Eigenschaft per Namen oder per Index erhalten werden.
BuiltInDocumentProperties bietet zusätzlich Zugriff auf Dokumenteigenschaften durch eine Reihe von eingegebenen Eigenschaften, die Rückgabewerte der entsprechenden Art. CustomDocumentProperties Sie können Dokumenteigenschaften aus einem Dokument hinzufügen oder entfernen.
Die DocumentProperty class ermöglicht es Ihnen, den Namen, den Wert und die Art einer Dokumenten-Eigenschaft zu erhalten. [Wert]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) gibt ein Objekt zurück, aber es gibt eine Reihe von Methoden, mit brauchen Sie den Eigenschaftenswert in einem bestimmten Typ erhalten können. Nach oben Sie wissen, welche Art der Immobilie ist, können Sie eine der {0} Verfahren, wie {1}(ToString)](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/#toString) und DocumentProperty.ToInt, den Wert des entsprechenden Typs zu erhalten.
Das folgende Codebeispiel zeigt, wie man alle eingebauten und benutzerdefinierten Eigenschaften in einem Dokument auszählt:
In Microsoft Word, Sie können über das Menü “Datei → Eigenschaften” auf Dokumenteigenschaften zugreifen.
Hinzufügen oder Entfernen von Dokumenteneigenschaften
Sie können integrierte Dokumenteigenschaften nicht hinzufügen oder entfernen Aspose.Words. Sie können nur ihre Werte ändern oder aktualisieren.
Um benutzerdefinierte Dokumenteigenschaften hinzuzufügen Aspose.Words, verwenden, Add Verfahren, Weitergabe des neuen Eigenschaftsnamens und des Wertes der entsprechenden Art. Die Methode gibt das neu erstellte zurück DocumentProperty Objekt.
Um benutzerdefinierte Eigenschaften zu entfernen, verwenden Sie die Remove Methode, es den Eigenschaftsnamen zu entfernen, oder die RemoveAt Methode, um die Eigenschaft per Index zu entfernen. Sie können auch alle Eigenschaften mit der Clear Methode.
Das folgende Codebeispiel prüft, ob in einem Dokument eine benutzerdefinierte Eigenschaft mit einem bestimmten Namen existiert und einige benutzerdefinierte Dokumenteigenschaften hinzufügt:
Das folgende Codebeispiel zeigt, wie man eine benutzerdefinierte Dokument-Eigenschaft entfernt:
Aktualisieren von integrierten Dokumenteneigenschaften
Aspose.Words nicht automatisch Dokumenteigenschaften aktualisieren, wie Microsoft Word hat einige Eigenschaften, bietet aber eine Methode, um einige statistische eingebaute Dokumenteigenschaften zu aktualisieren. Rufen Sie an UpdateWordCount Verfahren zur Neuberechnung und Aktualisierung der folgenden Eigenschaften:
Erstellen Sie ein neues Custom Property Linked to Content
Aspose.Words bietet AddLinkToContent Verfahren zur Erstellung einer neuen benutzerdefinierten Dokumenten-Eigenschaft, die mit Inhalten verknüpft ist. Diese Eigenschaft gibt das neu erstellte Objekt oder null zurück, wenn die LinkSource ist ungültig.
Das folgende Codebeispiel zeigt, wie man einen Link zu einer benutzerdefinierten Eigenschaft konfiguriert:
Dokumentvariablen erhalten
Sie können eine Sammlung von Dokumentvariablen mit der Variables Eigentum. Variable Namen und Werte sind Strings.
Das folgende Codebeispiel zeigt, wie man Dokumentvariablen auszählt:
Entfernen Sie personenbezogene Daten von Dokument
Wenn Sie ein Word-Dokument mit anderen Personen teilen möchten, können Sie persönliche Informationen wie Autorname und Firma entfernen möchten. Um dies zu tun, verwenden Sie RemovePersonalInformation Eigenschaft, die Flagge zu setzen, die angibt, dass Microsoft Word alle Benutzerinformationen von Kommentaren, Revisionen und Dokumenteigenschaften beim Speichern des Dokuments entfernen.