Поделиться через

Чтение и запись в свойства документа

  • Статья

Свойства документа можно сохранять вместе с документом. Приложения Office содержат различные встроенные свойства, например автора, название и тему. В этом разделе показано, как задать свойства документа в Microsoft Office Excel и Microsoft Office Word.

Область применения: сведения в этом разделе относятся к проектам на уровне документа и проектам надстроек VSTO для следующих приложений: Excel; Powerpoint; Проекта; Слово. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

Задание свойств документа в Excel

Для работы со встроенными свойствами в Excel используйте следующие свойства.

  • В проекте на уровне документа используйте свойство BuiltinDocumentProperties класса ThisWorkbook .

  • В проекте надстройки VSTO используйте свойство BuiltinDocumentProperties объекта Workbook .

    Эти свойства возвращают объект DocumentProperties , который представляет собой коллекцию объектов DocumentProperty . Для извлечения конкретного свойства по имени или по индексу в коллекции можно использовать свойство Item коллекции.

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

Изменение свойства «Номер редакции» в Excel

  1. Назначьте переменной встроенные свойства документа.

    Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisWorkbook.BuiltinDocumentProperties; 

Microsoft.Office.Core.DocumentProperty prop;
prop = properties["Revision Number"];

  2. Увеличьте значение свойства Revision Number на единицу.

    if (prop.Value == null)
{
    prop.Value = 1;
}
else
{
    int revision;
    if (int.TryParse((string)prop.Value, out revision))
    {
        prop.Value = revision + 1;
        MessageBox.Show("Revision Number = " + revision);
    }
    else
    {
        MessageBox.Show("Revision Number = invalid value");
    }
}

Задание свойств документа в Word

Для работы со встроенными свойствами в Word используйте следующие свойства.

  • В проекте на уровне документа используйте свойство BuiltInDocumentProperties класса ThisDocument .

  • В проекте надстройки VSTO используйте свойство BuiltInDocumentProperties объекта Document .

    Эти свойства возвращают объект DocumentProperties , который представляет собой коллекцию объектов DocumentProperty . Для извлечения конкретного свойства по имени или по индексу в коллекции можно использовать свойство Item коллекции.

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

Изменение свойства темы

  1. Назначьте переменной встроенные свойства документа.

    Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisDocument.BuiltInDocumentProperties;

  2. Измените значение свойства Subject на «Техническая документация».

    // Set the Subject property. 
properties["Subject"].Value = "Whitepaper";

Отказоустойчивость

В примерах предполагается, что код написан в классе ThisWorkbook в проекте на уровне документа для Excel и в классе ThisDocument в проекте на уровне документа для Word.

Несмотря на то что вы работаете с Word и Excel и их объектами, Microsoft Office предоставляет список доступных встроенных свойств документа. В случае попытки доступа к неопределенному свойству возникает исключение.

Связанный контент