Praca z właściwościami dokumentu
Właściwości dokumentu pozwalają na przechowywanie pewnych przydatnych informacji o dokumencie. Właściwości te można podzielić na dwie grupy:
- System lub built- in, które zawierają wartości takie jak tytuł dokumentu, nazwa autora, statystyki dokumentów i inne.
- User- definiowane lub niestandardowe, dostarczane jako pary wartości nazw, gdzie użytkownik może zdefiniować zarówno nazwę jak i wartość.
Warto wiedzieć, że informacje na temat API i numer wersji jest bezpośrednio zapisywany do dokumentów wyjściowych. Na przykład, po konwersji dokumentu do PDF, Aspose.Words wypełnia pole “Aplikacja” z “Aspose.Words"i” PDF producent “pole z"Aspose.Words zamiast Java RR.M.N “, gdzie YY.M.N jest wersją Aspose.Words używane do konwersji. Więcej informacji na ten temat znajduje się w sekcji Generator lub Nazwa producenta Zawarte w dokumentach wyciągniętych.
Właściwości dokumentu dostępu
Aby uzyskać dostęp do właściwości dokumentów w Aspose.Words podanie:
-
BuiltInDocumentProperties aby uzyskać built- in nieruchomości.
-
CustomDocumentProperties do uzyskania właściwości niestandardowych.
BuiltInDocumentProperties oraz CustomDocumentProperties są kolekcjami DocumentProperty obiektów. Obiekty te można uzyskać przez właściwość indeksera według nazwy lub indeksu.
BuiltInDocumentProperties dodatkowo zapewnia dostęp do właściwości dokumentu poprzez zestaw wprowadzonych właściwości, które zwracają wartości odpowiedniego typu. CustomDocumentProperties umożliwia dodanie lub usunięcie właściwości dokumentu z dokumentu.
W DocumentProperty klasa pozwala uzyskać nazwę, wartość i typ właściwości dokumentu. [Value] https: / / reference.aspose.com / words / java / com.aspose.words / documentproperty # Value) zwraca obiekt, ale istnieje zestaw metad umorzenia wartości własności przemysłowej na okreslony typ. Po wejściu typu nieruchomości, może wystąpić jedno z {0} Metody, takie jak {1}ToString oraz DocumentProperty.ToInt, uzyskanie wartości odpowiedniego typu.
Poniższy przykład kodu pokazuje, jak zapisać wszystkie wbudowane i niestandardowe właściwości w dokumencie:
W Microsoft Word, można uzyskać dostęp do właściwości dokumentu za pomocą menu “Plik → Właściwości”.
Dodaj lub usuń właściwości dokumentu
Nie można dodawać lub usuwać właściwości built- in dokumentu za pomocą Aspose.Words. Możesz tylko zmieniać lub aktualizować ich wartości.
Aby dodać niestandardowe właściwości dokumentu z Aspose.Words, stosować Add metoda, podająca nową nazwę właściwości i wartość odpowiedniego typu. Metoda zwraca nowo utworzone DocumentProperty obiekt.
Aby usunąć niestandardowe właściwości, użyj Remove metody, podając jej nazwę właściwości do usunięcia, lub RemoveAt metoda usuwania właściwości przez indeks. Można również usunąć wszystkie właściwości za pomocą Clear Metoda.
Poniższy przykład kodu sprawdza, czy właściwość własna o podanej nazwie istnieje w dokumencie i dodaje kilka innych właściwości dokumentu:
Poniższy przykład kodu pokazuje jak usunąć właściwość dokumentu:
Aktualizuj właściwości built- In Document
Aspose.Words nie aktualizuje automatycznie właściwości dokumentu, jak Microsoft Word posiada pewne właściwości, ale dostarcza metody do aktualizacji niektórych statystycznych built- w właściwościach dokumentu. Zadzwoń UpdateWordCount metoda przeliczania i aktualizacji następujących właściwości:
Utwórz nową właściwość użytkownika powiązaną z treścią
Aspose.Words zapewnia AddLinkToContent metoda tworzenia nowej właściwości dokumentu niestandardowego powiązanej z treścią. Ta właściwość zwraca nowo utworzony obiekt właściwości lub null jeśli LinkSource jest nieważny.
Poniższy przykład kodu pokazuje jak skonfigurować link do właściwości niestandardowych:
Pobierz zmienne dokumentu
Możesz uzyskać zbiór zmiennych dokumentu za pomocą Variables nieruchomości. Zmienne nazwy i wartości są strunami.
Poniższy przykład kodu pokazuje, jak zapisać zmienne dokumentu:
Usuń dane osobowe z dokumentu
Jeśli chcesz podzielić się dokumentem Word z innymi ludźmi, możesz usunąć dane osobowe, takie jak nazwisko autora i firma. Aby to zrobić należy użyć RemovePersonalInformation właściwość do ustawienia znacznika wskazująca, że Microsoft Word usunie wszystkie informacje o użytkowniku z komentarzy, poprawek i właściwości dokumentu po zapisaniu dokumentu.