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

Свойствата на документа позволяват съхраняване на полезна информация за вашия документ. Тези свойства могат да бъдат разделени на две групи.:

  • Система или вградени, които съдържат стойности, като например заглавие на документа, име на автора, статистика на документа и други.
  • Дефинирани от потребителя или по избор, предоставени като двойки име-стойност, където потребителят може да определи както името, така и стойността.

Полезно е да знаете, че информацията за API и номера на версията се записва директно в изходните документи. Например при конвертиране на документ в PDF Aspose.Words попълва полето “заявление” с “Aspose.Words”, а полето “PDF производител” с “Aspose.Words за C++ YY.М. н”, където YY.M.N е версията на Aspose.Words, използвана за преобразуване. За повече подробности вижте Генератор или име на производителя, включени в изходните документи.

Свойства На Документа За Достъп

За достъп до свойствата на документа в Aspose.Words използвайте:

BuiltInDocumentProperties

BuiltInDocumentProperties

Клас 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 метод за създаване на ново свойство на персонализиран документ, свързано със съдържание. Това свойство връща новосъздадения обект на свойство или нула, ако LinkSource е невалиден.

Следващият пример за код показва как да конфигурирате връзка към свойство по избор:

Получаване На Променливи На Документа

Можете да получите колекция от променливи на документа, като използвате свойството Variables. Имената и стойностите на променливите са низове.

Следващият пример за код показва как да се изброят променливите на документа:

Премахване на лична информация от документ

Ако искате да споделите документ Word с други хора, може да искате да премахнете лична информация като име на автора и фирма. За да направите това, използвайте свойството RemovePersonalInformation, за да зададете флага, показващ, че Microsoft Word ще премахне цялата информация за потребителя от коментари, ревизии и свойства на документа при записване на документа.

Следният пример за код показва как да премахнете лична информация:

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