Arbeiten 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, die Werte wie Dokumenttitel, Autorenname, Dokumentstatistik und andere enthalten.
  • 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. Wenn Sie beispielsweise ein Dokument in PDF konvertieren, füllt Aspose.Words das Feld “Anwendung” mit “Aspose.Words” und das Feld “PDF Produzent” mit “Aspose.Words für C++ YY.M.N”, wobei YY.M.N die Version von Aspose.Words ist, die für die Konvertierung verwendet wird. Weitere Einzelheiten finden Sie unter Name des Generators oder Herstellers in Ausgabedokumenten enthalten.

Auf Dokumenteigenschaften zugreifen

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

BuiltInDocumentProperties

BuiltInDocumentProperties

Mit der Klasse DocumentProperty können Sie den Namen, den Wert und den Typ einer Dokumenteigenschaft abrufen. Value gibt ein Objekt zurück, aber es gibt eine Reihe von Methoden, mit denen Sie den Eigenschaftswert in einen bestimmten Typ konvertieren können. Nachdem Sie erfahren haben, um welchen Typ es sich bei der Eigenschaft handelt, können Sie eine der DocumentProperty.ToXXX-Methoden verwenden, z. B. DocumentProperty.ToString und DocumentProperty.ToInt, um den Wert des entsprechenden Typs zu ermitteln.

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

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

work-with-document-properties-aspose-words-cpp_1.png

Dokumenteigenschaften hinzufügen oder entfernen

Sie können integrierte Dokumenteigenschaften nicht mit Aspose.Words hinzufügen oder entfernen. Sie können nur ihre Werte ändern oder aktualisieren.

Um benutzerdefinierte Dokumenteigenschaften mit Aspose.Words hinzuzufügen, verwenden Sie die Methode Add und übergeben Sie 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 Methode Remove und übergeben Sie den zu entfernenden Eigenschaftsnamen oder die Methode RemoveAt, um die Eigenschaft nach Index zu entfernen. Sie können auch alle Eigenschaften mit der Methode Clear entfernen.

Das folgende Codebeispiel überprü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 Sie eine benutzerdefinierte Dokumenteigenschaft entfernen:

Aktualisieren der integrierten Dokumenteigenschaften

Aspose.Words aktualisiert Dokumenteigenschaften nicht automatisch, wie es Microsoft Word bei einigen Eigenschaften tut, sondern bietet eine Methode zum Aktualisieren einiger statistischer integrierter Dokumenteigenschaften. Rufen Sie die Methode UpdateWordCount auf, um die folgenden Eigenschaften neu zu berechnen und zu aktualisieren:

Erstellen einer neuen benutzerdefinierten Eigenschaft, die mit Inhalten verknüpft ist

Aspose.Words stellt die Methode AddLinkToContent bereit, um eine neue benutzerdefinierte Dokumenteigenschaft zu erstellen, die mit Inhalt verknüpft ist. Diese Eigenschaft gibt das neu erstellte Eigenschaftsobjekt oder null zurück, wenn LinkSource ungültig ist.

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

Dokumentvariablen abrufen

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

Das folgende Codebeispiel zeigt, wie Dokumentvariablen aufgelistet werden:

Persönliche Informationen aus dem Dokument entfernen

Wenn Sie ein Word-Dokument für andere Personen freigeben möchten, möchten Sie möglicherweise persönliche Informationen wie den Namen des Autors und die Firma entfernen. Verwenden Sie dazu die Eigenschaft RemovePersonalInformation, 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 Sie persönliche Informationen entfernen:

Umrechnung zwischen Maßeinheiten in C++