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.

Zauważ, że nie może kierować Aspose.Words zmienić lub usunąć te informacje z dokumentów wyjściowych.

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:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
String fileName = dataDir + "Properties.doc";
Document doc = new Document(fileName);

System.out.println("1. Document name: " + fileName);

System.out.println("2. Built-in Properties");
for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
	System.out.println(prop.getName() + " : " + prop.getValue());

System.out.println("3. Custom Properties");
for (DocumentProperty prop : doc.getCustomDocumentProperties())
	System.out.println(prop.getName() + " : " + prop.getValue());

Możesz pobrać plik szablonu tego przykładu z Aspose.Words GitHub.

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:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Properties.doc");

CustomDocumentProperties props = doc.getCustomDocumentProperties();

if (props.get("Authorized") == null) {
	props.add("Authorized", true);
	props.add("Authorized By", "John Smith");
	props.add("Authorized Date", new Date());
	props.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
	props.add("Authorized Amount", 123.45);
}

Możesz pobrać plik szablonu tego przykładu z Aspose.Words GitHub.

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Properties.doc");
doc.getCustomDocumentProperties().remove("Authorized Date");

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:

• Characters
• CharactersWithSpaces
• Words
• Paragraphs
• Lines

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:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "test.docx");

// Retrieve a list of all custom document properties from the file.
CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();

// Add linked to content property.
DocumentProperty customProperty = customProperties.addLinkToContent("PropertyName", "BookmarkName");

// Also, accessing the custom document property can be performed by using the
// property name.
customProperty = customProperties.get("PropertyName");

// Check whether the property is linked to content.
boolean isLinkedToContent = customProperty.isLinkToContent();

// Get the source of the property.
String source = customProperty.getLinkSource();

// Get the value of the property.
String value = customProperty.getValue().toString();

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:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.doc");

for (java.util.Map.Entry entry : doc.getVariables()) {
	String name = entry.getKey().toString();
	String value = entry.getValue().toString();

	// Do something useful.
	System.out.println("Name: " + name + ", Value: " + value);
}

Możesz pobrać plik szablonu tego przykładu z Aspose.Words GitHub.

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.

Ustawienie tej opcji nie usuwa danych osobowych podczas przetwarzania dokumentu w Aspose.Words i dotyczy tylko Microsoft Word zachowanie.