Управление свойствами документа

Возможные сценарии использования

Aspose.Cells позволяет работать с встроенными и настраиваемыми свойствами документа. Здесь представлен интерфейс Microsoft Excel для открытия этих свойств документа. Просто щелкните Дополнительные свойства, как показано на этом скриншоте, и просмотрите их.

Управление свойствами документа

В следующем примере кода загружается образец файла Excel и считываются встроенные свойства документа, например, Название, Тема, а затем они изменяются. Затем также считывается настраиваемое свойство документа, т.е. MyCustom1, и затем добавляется новое настраиваемое свойство документа, т. е. MyCustom5, и записывается выходной файл Excel. На следующем скриншоте показан эффект примера кода на образец файла Excel.

Образец кода

Aspose::Cells::Startup();

//For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

//Source directory path
U16String dirPath(u"..\\Data\\LoadingSavingAndConverting\\");

//Output directory path
U16String outPath(u"..\\Data\\Output\\");

//Paths of source and output excel files
U16String samplePath(dirPath + u"sampleManagingDocumentProperties.xlsx");
U16String outputPath(outPath + u"outputManagingDocumentProperties.xlsx");

//Load the sample excel file
Workbook wb(samplePath);

//Read built-in title and subject properties
U16String strTitle = wb.GetBuiltInDocumentProperties().GetTitle();
U16String strSubject = wb.GetBuiltInDocumentProperties().GetSubject();

U16String title(u"Title: ");
std::cout << title.ToUtf8() << strTitle.ToUtf8() << std::endl;
U16String subject(u"Subject: ");
std::cout << subject.ToUtf8()<<strSubject.ToUtf8() << std::endl;

//Modify built-in title and subject properties
strTitle = u"Aspose.Cells New Title";
strSubject = u"Aspose.Cells New Subject";
wb.GetBuiltInDocumentProperties().SetTitle(strTitle);
wb.GetBuiltInDocumentProperties().SetSubject(strSubject);

//Read the custom property
U16String strCustomPropName(u"MyCustom1");
U16String strCustomPropValue = wb.GetCustomDocumentProperties().Get(strCustomPropName).ToString();
U16String myCustom1(u"\r\nMyCustom1: ");
std::cout << myCustom1.ToUtf8()<<strCustomPropValue.ToUtf8() << std::endl;

//Add a new custom property
strCustomPropName = u"MyCustom5";
strCustomPropValue = u"This is my custom five.";
wb.GetCustomDocumentProperties().Add(strCustomPropName, strCustomPropValue);

//Save the output excel file
wb.Save(outputPath);

Aspose::Cells::Cleanup();

Вывод в консоль

Это вывод в консоль вышеуказанного примера кода при выполнении с предоставленным образцом файла Excel.

 Title: Aspose Team

Subject: Aspose.Cells for C++

MyCustom1: This is my custom one.