Управление свойствами документа
Введение
Microsoft Excel предоставляет возможность добавлять свойства в файлы электронных таблиц. Эти свойства документа предоставляют полезную информацию и разделены на две категории, как описано ниже.
- Системные (встроенные) свойства. Встроенные свойства содержат общую информацию о документе, например название документа, имя автора, статистику документа и т. д.
- Пользовательские (настраиваемые) свойства: пользовательские свойства, определенные конечным пользователем в форме пары имя-значение.
Как управлять свойствами документа с помощью Microsoft Excel
Microsoft Excel позволяет управлять свойствами файлов Excel в режиме WYSIWYG. Пожалуйста, следуйте инструкциям ниже, чтобы открытьХарактеристики диалог в Excel 2016.
- ИзФайл меню выберите Информация*.
| Выбор информационного меню |
|---|
 |
- Нажмите наХарактеристики заголовок и выберите «Дополнительные свойства».
| Нажатие кнопки «Выбор дополнительных свойств» |
|---|
 |
- Управляйте свойствами документа файла.
| Диалог свойств |
|---|
 |
| В диалоговом окне «Свойства» есть различные вкладки, такие как «Общие», «Сводка», «Статистика», «Содержимое» и «Пользовательские». Каждая вкладка помогает настроить различные виды информации, связанной с файлом. Вкладка «Пользовательские» используется для управления пользовательскими свойствами. |
Как работать со свойствами документа с помощью Aspose.Cells
Разработчики могут динамически управлять свойствами документа с помощью API Aspose.Cells. Эта функция помогает разработчикам хранить полезную информацию вместе с файлом, например, когда файл был получен, обработан, с отметкой времени и т. д.
Aspose.Cells for .NET напрямую записывает информацию о API и номере версии в выходные документы. Например, при рендеринге документа в PDF, Aspose.Cells for .NET заполняетсяПриложение поле со значением «Aspose.Cells» иPDF Производитель поле со значением, например, «Aspose.Cells v17.9».
Обратите внимание, что вы не можете дать указание Aspose.Cells for .NET изменить или удалить эту информацию из выходных документов.
Как получить доступ к свойствам документа
Aspose.Cells API поддерживают оба типа свойств документа: встроенные и настраиваемые. Aspose.Cells'Рабочая тетрадь класс представляет файл Excel и, как и файл Excel,Рабочая тетрадь класс может содержать несколько листов, каждый из которых представленРабочий лист класс, тогда как коллекция рабочих листов представлена классомРабочий ЛистКоллекциясорт.
ИспользоватьРабочий ЛистКоллекциядля доступа к свойствам документа файла, как описано ниже.
- Чтобы получить доступ к встроенным свойствам документа, используйтеWorksheetCollection.BuiltInDocumentProperties.
- Чтобы получить доступ к пользовательским свойствам документа, используйтеWorksheetCollection.CustomDocumentProperties.
ОбаWorksheetCollection.BuiltInDocumentProperties иWorksheetCollection.CustomDocumentProperties вернуть экземплярAspose.Cells.Properties.DocumentPropertyCollection. Эта коллекция содержитAspose.Cells.Properties.DocumentPropertyобъекты, каждый из которых представляет одно встроенное или настраиваемое свойство документа.
То, как получить доступ к свойству, зависит от требований приложения; используя индекс или имя свойства изDocumentPropertyCollectionкак показано в примере ниже.
Aspose.Cells.Properties.DocumentPropertyКласс позволяет получить имя, значение и тип свойства документа:
- Чтобы получить имя свойства, используйтеДокументСвойство.Имя.
- Чтобы получить значение свойства, используйтеДокументСвойство.Значение. ДокументСвойство.Значениевозвращает значение как объект.
- Чтобы получить тип свойства, используйтеДокументСвойство.Тип . Это возвращает один изТип собственностизначения перечисления. После получения типа свойства используйте один изДокументПроперти.ToXXX методы для получения значения соответствующего типа вместо использованияДокументСвойство.Значение .ДокументПроперти.ToXXXметоды описаны в таблице ниже.
| Имя участника | Описание | Метод ToXXX |
|---|---|---|
| логическое значение | Тип данных свойства — логический. | ТоБул |
| Дата | Тип данных свойства — DateTime. Обратите внимание, что Microsoft Excel хранит только часть даты, время не может быть сохранено в настраиваемом свойстве этого типа |
Тодатевремя |
| Плавать | Тип данных свойства — Double. | Удвоить |
| Число | Тип данных свойства — Int32. | ТоИнт |
| String | Тип данных свойства — String. | Нанизывать |
Как добавить или удалить пользовательские свойства документа
Как мы описывали ранее в начале этой темы, разработчики не могут добавлять или удалять встроенные свойства, поскольку эти свойства определяются системой, но можно добавлять или удалять пользовательские свойства, поскольку они определяются пользователем.
Как добавить пользовательские свойства
Aspose.Cells API раскрылиДобавлять метод дляCustomDocumentPropertyCollection class, чтобы добавить в коллекцию пользовательские свойства.Добавлять метод добавляет свойство в файл Excel и возвращает ссылку на новое свойство документа в видеAspose.Cells.Properties.DocumentPropertyобъект.
Как настроить настраиваемое свойство «Ссылка на контент»
Чтобы создать настраиваемое свойство, связанное с содержимым заданного диапазона, вызовите методCustomDocumentPropertyCollection.AddLinkToContent метод и передайте имя и источник свойства. Вы можете проверить, настроено ли свойство как связанное с контентом, используяDocumentProperty.IsLinkedToContent свойство. Более того, также возможно получить исходный диапазон, используяИсточник собственностьДокументСвойствосорт.
В примере мы используем простой шаблон Microsoft файла Excel. В рабочей книге есть определенный именованный диапазон с меткойМойдиапазон который относится к значению ячейки.
Как удалить пользовательские свойства
Чтобы удалить пользовательские свойства по номеру Aspose.Cells, позвоните по телефонуDocumentPropertyCollection.Removeи передайте имя свойства документа, которое нужно удалить.