Pracuj z właściwościami dokumentu

Właściwości dokumentu umożliwiają przechowywanie przydatnych informacji o dokumencie. Właściwości te można podzielić na dwie grupy:

  • Systemowe lub wbudowane, które zawierają wartości takie jak tytuł dokumentu, nazwisko autora, statystyki dokumentu i inne.
  • Zdefiniowane przez użytkownika lub niestandardowe, dostarczane jako pary nazwa-wartość, w których użytkownik może zdefiniować zarówno nazwę, jak i wartość.

Warto wiedzieć, że informacje o API i numerze wersji są bezpośrednio zapisywane w dokumentach wyjściowych. Na przykład po konwersji dokumentu do formatu PDF Aspose.Words wypełnia pole “Aplikacja” wartością “Aspose.Words”, a pole “Producent PDF” wartością “Aspose.Words for .NET YY.MN”, gdzie YY.M.N to wersja Aspose.Words używana do konwersji. Więcej szczegółów znajdziesz w Nazwa generatora lub producenta zawarta w dokumentach wyjściowych.

Uzyskaj dostęp do właściwości dokumentu

Aby uzyskać dostęp do właściwości dokumentu w formacie Aspose.Words, użyj:

built_in_document_properties i custom_document_properties to zbiory obiektów DocumentProperty. Obiekty te można uzyskać za pomocą właściwości indeksatora według nazwy lub indeksu.

built_in_document_properties dodatkowo zapewnia dostęp do właściwości dokumentu poprzez zestaw wprowadzanych właściwości, które zwracają wartości odpowiedniego typu. custom_document_properties umożliwia dodawanie lub usuwanie właściwości dokumentu z dokumentu.

Klasa DocumentProperty pozwala uzyskać nazwę, wartość i typ właściwości dokumentu. value zwraca obiekt, ale istnieje zestaw metod umożliwiających przekonwertowanie wartości właściwości na określony typ. Po zapoznaniu się z typem właściwości można skorzystać z jednej z metod Właściwość dokumentu.to_XXX, np. Właściwość dokumentu.__str__ i DocumentProperty.to_int, w celu uzyskania wartości odpowiedniego typu.

Poniższy przykład kodu pokazuje, jak wyliczyć wszystkie właściwości wbudowane i niestandardowe w dokumencie:

W Microsoft Word dostęp do właściwości dokumentu można uzyskać za pomocą menu “Plik → Właściwości”.

praca z-właściwościami-dokumentu-1.png

Dodaj lub usuń właściwości dokumentu

Nie można dodawać ani usuwać wbudowanych właściwości dokumentu za pomocą Aspose.Words. Można jedynie zmieniać lub aktualizować ich wartości.

Aby dodać niestandardowe właściwości dokumentu za pomocą Aspose.Words, użyj metody add, przekazując nową nazwę właściwości i wartość odpowiedniego typu. Metoda zwraca nowo utworzony obiekt DocumentProperty.

Aby usunąć właściwości niestandardowe, użyj metody remove, przekazując jej nazwę właściwości do usunięcia, lub metody remove_at, aby usunąć właściwość według indeksu. Możesz także usunąć wszystkie właściwości za pomocą metody clear.

Poniższy przykład kodu sprawdza, czy w dokumencie istnieje niestandardowa właściwość o podanej nazwie i dodaje kilka dodatkowych niestandardowych właściwości dokumentu:

Poniższy przykład kodu pokazuje, jak usunąć niestandardową właściwość dokumentu:

Zaktualizuj wbudowane właściwości dokumentu

Aspose.Words nie aktualizuje automatycznie właściwości dokumentu, jak robi to Microsoft Word w przypadku niektórych właściwości, ale zapewnia metodę aktualizacji niektórych wbudowanych właściwości statystycznych dokumentu. Wywołaj metodę update_word_count, aby ponownie obliczyć i zaktualizować następujące właściwości:

Utwórz nową właściwość niestandardową połączoną z zawartością

Aspose.Words udostępnia metodę add_link_to_content do tworzenia nowej niestandardowej właściwości dokumentu powiązanej z treścią. Ta właściwość zwraca nowo utworzony obiekt właściwości lub wartość null, jeśli plik źródło_linku jest nieprawidłowy.

Poniższy przykład kodu pokazuje, jak skonfigurować łącze do właściwości niestandardowej:

Pobierz zmienne dokumentu

Kolekcję zmiennych dokumentu można uzyskać za pomocą właściwości variables. Nazwy i wartości zmiennych są ciągami znaków.

Poniższy przykład kodu pokazuje, jak dodawać zmienne dokumentu i uzyskiwać do nich dostęp:

Usuń dane osobowe z dokumentu

Jeśli chcesz udostępnić dokument programu Word innym osobom, możesz usunąć dane osobowe, takie jak imię i nazwisko autora i firma. Aby to zrobić, użyj właściwości remove_personal_information, aby ustawić flagę wskazującą, że Microsoft Word usunie wszystkie informacje o użytkowniku z komentarzy, wersji i właściwości dokumentu po zapisaniu dokumentu.

Poniższy przykład kodu pokazuje, jak usunąć dane osobowe:

Konwersja między jednostkami miary