Arbeiten Sie mit Dokumenteigenschaften

Dokumenteigenschaften ermöglichen das Speichern einiger nützlicher Informationen zu Ihrem Dokument. Diese Eigenschaften können in zwei Gruppen unterteilt werden:

  • System oder integriert, das Werte wie Dokumenttitel, Autorenname, Dokumentstatistiken und andere enthält.
  • Benutzerdefiniert oder benutzerdefiniert, bereitgestellt als Name-Wert-Paare, wobei der Benutzer sowohl den Namen als auch den Wert definieren kann.

Es ist nützlich zu wissen, dass Informationen zu API und Versionsnummer direkt in Ausgabedokumente geschrieben werden. Beispielsweise füllt Aspose.Words beim Konvertieren eines Dokuments in PDF das Feld “Anwendung” mit “Aspose.Words” und das Feld “PDF-Produzent” mit “Aspose.Words für .NET YY.MN” aus, wobei YY.M.N die für die Konvertierung verwendete Aspose.Words-Version ist. Weitere Einzelheiten finden Sie unter Der Name des Generators oder Produzenten ist in den Ausgabedokumenten enthalten.

Greifen Sie auf die Dokumenteigenschaften zu

Um auf Dokumenteigenschaften in Aspose.Words zuzugreifen, verwenden Sie:

built_in_document_properties und custom_document_properties sind Sammlungen von DocumentProperty-Objekten. Diese Objekte können über die Indexer-Eigenschaft nach Namen oder Index abgerufen werden.

built_in_document_properties bietet zusätzlich Zugriff auf Dokumenteigenschaften über eine Reihe eingegebener Eigenschaften, die Werte des entsprechenden Typs zurückgeben. Mit custom_document_properties können Sie Dokumenteigenschaften zu einem Dokument hinzufügen oder daraus entfernen.

Mit der DocumentProperty-Klasse können Sie den Namen, den Wert und den Typ einer Dokumenteigenschaft abrufen. value gibt ein Objekt zurück, es gibt jedoch eine Reihe von Methoden, mit denen Sie den Eigenschaftswert in einen bestimmten Typ konvertieren können. Nachdem Sie den Typ der Eigenschaft kennengelernt haben, können Sie eine der DocumentProperty.to_XXX-Methoden wie DocumentProperty.__str__ und DocumentProperty.to_int verwenden, um den Wert des entsprechenden Typs abzurufen.

Das folgende Codebeispiel zeigt, wie alle integrierten und benutzerdefinierten Eigenschaften in einem Dokument aufgezählt werden:

In Microsoft Word können Sie über das Menü “Datei → Eigenschaften” auf die Dokumenteigenschaften zugreifen.

/words/python-net/work-with-document-properties/work-with-document-properties-1.png

Dokumenteigenschaften hinzufügen oder entfernen

Mit Aspose.Words können Sie keine integrierten Dokumenteigenschaften hinzufügen oder entfernen. Sie können nur deren Werte ändern oder aktualisieren.

Um benutzerdefinierte Dokumenteigenschaften mit Aspose.Words hinzuzufügen, verwenden Sie die add-Methode und übergeben den neuen Eigenschaftsnamen und den Wert des entsprechenden Typs. Die Methode gibt das neu erstellte DocumentProperty-Objekt zurück.

Um benutzerdefinierte Eigenschaften zu entfernen, verwenden Sie die remove-Methode, indem Sie ihr den zu entfernenden Eigenschaftsnamen übergeben, oder die remove_at-Methode, um die Eigenschaft nach Index zu entfernen. Sie können alle Eigenschaften auch mithilfe der clear-Methode entfernen.

Das folgende Codebeispiel prüft, ob eine benutzerdefinierte Eigenschaft mit einem bestimmten Namen in einem Dokument vorhanden ist, und fügt einige weitere benutzerdefinierte Dokumenteigenschaften hinzu:

Das folgende Codebeispiel zeigt, wie eine benutzerdefinierte Dokumenteigenschaft entfernt wird:

Integrierte Dokumenteigenschaften aktualisieren

Aspose.Words aktualisiert Dokumenteigenschaften nicht automatisch, wie dies bei Microsoft Word bei einigen Eigenschaften der Fall ist, sondern bietet eine Methode zum Aktualisieren einiger statistischer integrierter Dokumenteigenschaften. Rufen Sie die update_word_count-Methode auf, um die folgenden Eigenschaften neu zu berechnen und zu aktualisieren:

Erstellen Sie eine neue benutzerdefinierte Eigenschaft, die mit Inhalt verknüpft ist

Aspose.Words bietet die add_link_to_content-Methode zum Erstellen einer neuen benutzerdefinierten Dokumenteigenschaft, die mit dem Inhalt verknüpft ist. Diese Eigenschaft gibt das neu erstellte Eigenschaftsobjekt oder null zurück, wenn das link_source ungültig ist.

Das folgende Codebeispiel zeigt, wie Sie einen Link zu einer benutzerdefinierten Eigenschaft konfigurieren:

Dokumentvariablen abrufen

Mithilfe der variables-Eigenschaft können Sie eine Sammlung von Dokumentvariablen abrufen. Variablennamen und -werte sind Zeichenfolgen.

Das folgende Codebeispiel zeigt, wie Sie Dokumentvariablen hinzufügen und darauf zugreifen:

Persönliche Informationen aus dem Dokument entfernen

Wenn Sie ein Word-Dokument mit anderen Personen teilen möchten, möchten Sie möglicherweise persönliche Informationen wie den Namen des Autors und das Unternehmen entfernen. Verwenden Sie dazu die remove_personal_information-Eigenschaft, um das Flag zu setzen, das angibt, dass Microsoft Word beim Speichern des Dokuments alle Benutzerinformationen aus Kommentaren, Revisionen und Dokumenteigenschaften entfernt.

Das folgende Codebeispiel zeigt, wie persönliche Informationen entfernt werden: