Praca 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:
- System 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ą zapisywane bezpośrednio w dokumentach wyjściowych. Na przykład po przekonwertowaniu dokumentu na PDF Aspose.Words wypełnia pole “aplikacja” za pomocą “Aspose.Words”, A pole “PDF Producent” za pomocą “Aspose.Words dla C++ YY.M. N”, gdzie YY.M.N jest wersją Aspose.Words używaną do konwersji. Aby uzyskać więcej informacji, zobacz Nazwa generatora lub producenta zawarta w dokumentach wyjściowych.
Dostęp Do Właściwości Dokumentu
Aby uzyskać dostęp do Właściwości dokumentu w Aspose.Words użyj:
-
BuiltInDocumentProperties aby uzyskać wbudowane właściwości.
-
CustomDocumentProperties aby uzyskać niestandardowe właściwości.
BuiltInDocumentProperties
BuiltInDocumentProperties
Klasa DocumentProperty pozwala uzyskać nazwę, wartość i typ właściwości dokumentu. Value zwraca obiekt, ale istnieje zestaw metod umożliwiających konwersję wartości właściwości na określony typ. Po zapoznaniu się z typem właściwości możesz użyć jednej z metod DocumentProperty.ToXXX, takich jak DocumentProperty.ToString i DocumentProperty.ToInt, aby uzyskać wartość odpowiedniego typu.
Poniższy przykład kodu pokazuje, jak wyliczyć wszystkie wbudowane i niestandardowe właściwości w dokumencie:
W Microsoft Word możesz uzyskać dostęp do Właściwości dokumentu za pomocą menu" Plik → Właściwości".
Dodawanie lub usuwanie Właściwości dokumentu
Nie można dodawać ani usuwać wbudowanych Właściwości dokumentu za pomocą Aspose.Words. Możesz tylko zmienić lub zaktualizować 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 RemoveAt do usunięcia właściwości 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 właściwość niestandardowa o podanej nazwie i dodaje kilka dodatkowych właściwości dokumentu niestandardowego:
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, tak jak Microsoft Word w przypadku niektórych właściwości, ale udostępnia metodę aktualizacji niektórych wbudowanych statystycznych Właściwości dokumentu. Wywołaj metodę UpdateWordCount, aby ponownie obliczyć i zaktualizować następujące właściwości:
Utwórz nową właściwość niestandardową połączoną z treścią
Aspose.Words udostępnia AddLinkToContent metodę tworzenia nowej niestandardowej Właściwości dokumentu połączonej z treścią. Ta właściwość zwraca nowo utworzony obiekt Właściwości lub null, Jeśli LinkSource jest nieprawidłowy.
Poniższy przykład kodu pokazuje, jak skonfigurować łącze do właściwości niestandardowej:
Pobierz Zmienne Dokumentu
Zbiór zmiennych dokumentu można uzyskać za pomocą właściwości Variables. Nazwy i wartości zmiennych są ciągami.
Poniższy przykład kodu pokazuje, jak wyliczyć zmienne dokumentu:
Usuń dane osobowe z dokumentu
Jeśli chcesz udostępnić dokument Word innym osobom, możesz usunąć dane osobowe, takie jak nazwisko autora i firma. Aby to zrobić, użyj właściwości RemovePersonalInformation, 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: