Работа со свойствами документа

Свойства документа позволяют сохранить некоторую полезную информацию о вашем документе. Эти свойства можно разделить на две группы:

  • Системные или встроенные, содержащие такие значения, как название документа, имя автора, статистика документа и другие.
  • Определяемые пользователем или пользовательские, предоставляемые в виде пар имя-значение, где пользователь может определить как имя, так и значение.

Полезно знать, что информация об API и номере версии напрямую записывается в выходные документы. Например, при преобразовании документа в PDF, Aspose.Words заполняет поле “Приложение” значением “Aspose.Words”, а поле “Производитель PDF” - значением “Aspose.Words для C++ YY.M.N”, где YY.M.N - это версия Aspose.Words, используемая для преобразования. Более подробную информацию смотрите в разделе Название генератора или производителя, указанное в выходных документах.

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

Чтобы получить доступ к свойствам документа в Aspose.Words, используйте:

Встроенные свойства документа

Встроенные свойства документа

Класс DocumentProperty позволяет получить имя, значение и тип свойства документа. Value возвращает объект, но существует набор методов, позволяющих преобразовать значение свойства в определенный тип. После того, как вы узнаете, к какому типу относится свойство, вы можете использовать один из методов DocumentProperty.ToXXX, таких как DocumentProperty.ToString и DocumentProperty.ToInt, чтобы получить значение соответствующего типа.

В следующем примере кода показано, как перечислить все встроенные и пользовательские свойства в документе:

В Microsoft Word вы можете получить доступ к свойствам документа, используя меню “Файл → Свойства”.

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

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

Вы не можете добавлять или удалять встроенные свойства документа, используя Aspose.Words. Вы можете только изменять или обновлять их значения.

Чтобы добавить пользовательские свойства документа с помощью Aspose.Words, используйте метод Add, передав имя нового свойства и значение соответствующего типа. Метод возвращает только что созданный объект DocumentProperty.

Чтобы удалить пользовательские свойства, используйте метод Remove, передав ему имя свойства для удаления, или метод RemoveAt, чтобы удалить свойство по индексу. Вы также можете удалить все свойства, используя метод Clear.

Следующий пример кода проверяет, существует ли в документе пользовательское свойство с заданным именем, и добавляет еще несколько пользовательских свойств документа:

В следующем примере кода показано, как удалить пользовательское свойство документа:

Обновление встроенных свойств документа

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

Создайте новое пользовательское свойство, связанное с контентом

Aspose.Words предоставляет метод AddLinkToContent для создания нового пользовательского свойства документа, связанного с содержимым. Это свойство возвращает только что созданный объект свойств или значение null, если значение LinkSource недопустимо.

В следующем примере кода показано, как настроить ссылку на пользовательское свойство:

Получение переменных документа

Вы можете получить набор переменных документа, используя свойство Variables. Имена и значения переменных являются строками.

В следующем примере кода показано, как перечислять переменные документа:

Удалить личную информацию из документа

Если вы хотите поделиться документом Word с другими пользователями, вы можете удалить личную информацию, такую как имя автора и компания. Для этого используйте свойство RemovePersonalInformation, чтобы установить флажок, указывающий на то, что Microsoft Word удалит всю пользовательскую информацию из комментариев, изменений и свойств документа при сохранении документа.

В следующем примере кода показано, как удалить личную информацию:

Преобразование между единицами измерения в C++