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

Статья
04/28/2010

Обновлен: Ноябрь 2007

Применимость
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Выпуск 2007 системы Microsoft Office Microsoft Office 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office.

Тип проекта

Проекты уровня документа

Версия Microsoft Office

Выпуск 2007 системы Microsoft Office
Microsoft Office 2003

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Можно сохранить свойства документа вместе с документом или книгой в настройках уровня документа для Microsoft Office Word и Microsoft Office Excel. Excel и Word предоставляют ряд встроенных свойств, таких как "Автор", "Заголовок" и "Тема".

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

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

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

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

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisWorkbook.BuiltinDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Dim prop As Microsoft.Office.Core.DocumentProperty
prop = properties.Item("Revision Number")

Microsoft.Office.Core.DocumentProperties properties;

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

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

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

If prop.Value Is Nothing Then
    prop.Value = 1
Else
    Dim revision As Integer
    If Integer.TryParse(prop.Value.ToString(), revision) Then
        prop.Value = revision + 1
        MessageBox.Show("Revision Number = " & revision)
    Else
        MessageBox.Show("Revision Number = invalid value")
    End If
End If

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

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

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

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

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisDocument.BuiltInDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Microsoft.Office.Core.DocumentProperties properties;

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

Измените значение свойства Subject на "Документация".

' Set the Subject property.
properties.Item("Subject").Value = "Whitepaper"

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

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

Данные примеры предполагают, что код написан в классе ThisWorkbook для Excel, и классе ThisDocument для Word.

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

См. также

Задачи

Практическое руководство. Создание и изменение настраиваемых свойств документа

Основные понятия

Настройки программирования уровня документа

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