Робота з документами

Властивості документів дозволяють зберігати інформацію про ваш документ. Ці властивості можна розділити на дві групи:

  • Система або вбудована, яка містить значення, такі як назва документа, назву автора, статистика документів та інші.
  • Ім’я * Визначені або користувацькі, надані як парі з іменем, де користувач може визначити як ім’я та значення.

Корисна інформація API та реєстраційний номер, безпосередньо написаний на вихідні документи. Наприклад, при конвертації документа в PDF, Aspose.Words заповнює поле “Застосування” з “Aspose.Words”, і поле “PDF Producer” з “Aspose.Words для Java YY.M.N, де YY.M.N - версія Aspose.Words використовується для перетворення. Більш детальна інформація Генератор або виробник ім’я включені в вихідні документий

Доступ до документів

Доступ до властивостей документа в Aspose.Words використання:

BuiltInDocumentProperties і CustomDocumentProperties колекції DocumentProperty об’єкти. Ці об’єкти можна отримати за допомогою індексатора за назвою або за індексом.

BuiltInDocumentProperties Додатково надає доступ до властивостей документів за допомогою набору введених властивостей, що повертає значення відповідного типу. CustomDocumentProperties увімкніть додавання або видалення властивостей документів з документа.

Про нас DocumentProperty клас дозволяє отримати ім’я, значення та тип майна документа. JavaРеєстрація API Веб-сайт Go1.13.8 Так, як ви, так і ви можете, ви можете зробити це з Java й API[Налаштування] і DocumentProperty.ToInt, отримувати значення відповідного типу.

Приклад коду показує, як об’єднати всі вбудовані та спеціальні властивості в документі:

// 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());

У Microsoft Word, Ви можете отримати доступ до властивостей документів за допомогою меню “Файл → Властивості”.

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

Додавання або видалення властивостей документів

Ви не можете додати або видалити вбудовані властивості документів Aspose.Wordsй Ви можете змінити або оновити свої значення.

Для додавання користувацьких властивостей документів Aspose.Words, використовувати Add метод, проходячи ім’я нового майна і значення відповідного типу. Метод повертає новостворений DocumentProperty об’єкт.

Щоб видалити спеціальні властивості, використовуйте Remove спосіб, проходячи його назву власності для видалення, або RemoveAt спосіб видалити майно за індексом. Ви також можете видалити всі властивості за допомогою Clear метод.

Приклад коду перевіряє, чи існує замовна власність з вказаною назвою в документі та додає декілька додаткових властивостей документа:

// 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);
}

Приклад коду показує, як видалити користувацький документ:

// 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");

Оновлення вбудованих документів

Aspose.Words не автоматично оновлює властивості документів, як Microsoft Word має деякі властивості, але надає метод оновлення деяких статистичних вбудованих властивостей документа. Дзвоните до UpdateWordCount спосіб перерахувати і оновити наступні властивості:

Створити новий користувацький контент

Aspose.Words забезпечує AddLinkToContent метод створення нового користувацького документа, пов’язаного з змістом. Ця властивість повертає новостворений об’єкт нерухомості або null, якщо LinkSource недійсний.

Приклад коду показує, як налаштувати посилання на спеціальне майно:

// 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();

Отримувати варіанти документів

Ви можете отримати збір змінних документів за допомогою Variables майно. Змінні імена і значення є рядками.

Приклад наступного коду показує, як об’єднати зміни документів:

// 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);
}

Видалити особисту інформацію з документа

Якщо ви хочете поділитися документом Word з іншими людьми, ви можете видалити персональні дані, такі як ім’я автора та компанія. Для цього використовуйте RemovePersonalInformation майно для встановлення прапора, що вказує на те, що Microsoft Word Видаліть всю інформацію користувача з коментарів, ревізій та властивостей документів при збереженні документа.