Манифесты приложений для решений Office (выпуск 2007 системы Microsoft Office)

Статья
11/05/2008

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

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

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

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

Тип проекта

Проекты уровня документа
Проекты уровня приложения

Версия Microsoft Office

Система Microsoft Office 2007

Манифест приложения в решении Visual Studio Tools for Office представляет собой XML-файл с описанием сборок, загруженных в решение Microsoft Office.

Решение Visual Studio Tools for Office использует схему манифеста приложения ClickOnce, которая определена в справке по Манифест приложения ClickOnce.

Манифесты приложений Visual Studio Tools for Office используют следующие элементы и атрибуты ClickOnce.

Элемент	Описание	Атрибуты
Элемент <assembly> (приложение ClickOnce)	Обязательно. Элемент верхнего уровня.	manifestVersion
Элемент <assemblyIdentity> (приложение ClickOnce)	Обязательно. Определяет основную сборку приложения ClickOnce.	name version publicKeyToken processorArchitecture language
Элемент <trustInfo> (приложение ClickOnce)	Определяет требования безопасности приложения.	Отсутствует
Элемент <entryPoint> (приложение ClickOnce)	Обязательно. Определяет точку входа в код приложения для выполнения.	name dependencyName customHostSpecified
Элемент <dependency> (приложение ClickOnce)	Обязательно. Определяет все зависимости, необходимые для выполнения приложения. При необходимости определяет сборки, которые требуется установить предварительно.	Отсутствует
Элемент <file> (приложение ClickOnce)	Обязательно. Определяет все не являющиеся сборками файлы, используемые приложением. Может включать данные изоляции COM, связанные с этим файлом.	name size

Манифесты приложений Visual Studio Tools for Office имеют следующий элемент в пространстве имен co.v1.

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Манифесты приложений Visual Studio Tools for Office также имеют следующие элементы и атрибуты в пространстве имен vstav2.

<addIn>
    <entryPoints>
        <entryPoint>
        </entryPoint>
    </entryPoints>
    <update></update>
    <application>
        <customization>
        </customization>
    </application
</addIn>

Элемент	Описание	Атрибуты
Элемент <customHostSpecified>	Обязательно. Помечает манифест как решение Office.	Отсутствует
Элемент <addin> (выпуск 2007 системы Office)	Обязательно. Хранит точки входа в одном пространстве имен.	Отсутствует
Элемент <entryPoints> (выпуск 2007 системы Office)	Обязательно. Группирует все сборки, которые необходимо запустить.	Отсутствует
Элемент <entryPoint> (выпуск 2007 системы Microsoft Office)	Обязательно. Определение сборку, которую необходимо запустить.	class contract
Элемент <update> (выпуск 2007 системы Microsoft Office)	Обязательно. Настраивает конфигурацию обновлений для решения.	enabled expiration
Элемент <application> (выпуск 2007 системы Microsoft Office)	Обязательно. Служит оболочкой в виде единого узла для хранения сведений о приложении.	Отсутствует
Элемент <customization> (выпуск 2007 системы Microsoft Office)	Обязательно. Хранит сведения о ведущем приложении в отдельном пространстве имен.	xmlns
Элемент <document> (выпуск 2007 системы Microsoft Office)	Является обязательным только для решений на уровне документа. Хранит сведения о настройках.	solutionId
Элемент <appAddin> (выпуск 2007 системы Microsoft Office)	Является обязательным только для решений на уровне приложения. Хранит сведения о настройках.	application loadBehavior keyName
Элемент <friendlyName> (выпуск 2007 системы Office)	Необязательно. Хранит имя надстройки, которое будет отображаться в списке установленных надстроек.	Отсутствует
Элемент <description> (выпуск 2007 системы Office)	Является обязательным только для надстроек на уровне приложения. Хранит описание, которое будет отображаться в списке установленных программ.	Отсутствует
Элемент <formRegions> (выпуск 2007 системы Microsoft Office)	Является обязательным только для надстроек Outlook 2007, в которых есть области форм.	Отсутствует
Элемент <formRegion> (выпуск 2007 системы Microsoft Office)	Является обязательным только для надстроек Outlook 2007, в которых есть области форм.	name

Заметки

Манифесты приложений и развертывания в решениях Visual Studio Tools for Office можно отредактировать вручную. Отредактированные манифесты приложений и развертывания необходимо подписать повторно с помощью средства генерирования и редактирования манифестов — Manifest Generation and Editing Tool (mage.exe и mageui.exe). Сначала подпишите манифест приложения, а затем манифест развертывания. Дополнительные сведения см. в разделах Средство создания и редактирования манифеста (Mage.exe) и Средство создания и редактирования манифестов, графический клиент (MageUI.exe).

Расположение файлов

Манифест приложения определяется для одной версии решения. По этой причине манифест приложения следует хранить отдельно от манифеста развертывания. Visual Studio помещает файлы, относящиеся к конкретной версии, в подкаталог, название которого соответствует версии, и который размещен в подкаталоге Файлы приложения каталога публикации.

Синтаксис имени файла

Имя файла манифеста приложения должно содержать полное имя и расширение приложения, определенные в элементе assemblyIdentity, и иметь расширение MANIFEST. Например, манифест приложения, ссылающийся на настройки OutlookAddIn1.dll будет иметь следующий синтаксис имени файла.

OutlookAddIn1.dll.manifest

ExcelWorkbook1.dll.manifest

Пример настройки на уровне документа

Описание

В приведенном ниже примере кода показаны разделы манифеста приложения, который относится к решению Visual Studio Tools for Office. Он представляет настройки на уровне документа Microsoft Office Excel 2007.

Код

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
        <vstov3:document
            solutionId="989..." />
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

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

Описание

В приведенном ниже примере кода показаны разделы манифеста приложения, который относится к решению Visual Studio Tools for Office. Это надстройка на уровне приложения для Microsoft Office Outlook 2007, в которой содержится область формы.

Код

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
            <assemblyIdentity
                name="OutlookAddIn1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
            <vstov3:appAddIn
                application="Outlook"
                loadBehavior="3"
                keyName="OutlookAddIn1">
                <vstov3:friendlyName>
                    OutlookAddIn1
                </vstov3:friendlyName>
                <vstov3:description>
                    OutlookAddIn1 - Outlook add-in created with 
                    Visual Studio Tools for Office
                </vstov3:description>
                <vstov3:formRegions>
                    <vstov3:formRegion
                        name="OutlookAddIn1.FormRegion1">
                        <vstov3:messageClass name="IPM.Note" />
                        <vstov3:messageClass name="IPM.Contact" />
                        <vstov3:messageClass name="IPM.Appointment" />
                    </vstov3:formRegion>
                </vstov3:formRegions>
            </vstov3:appAddIn>
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

См. также

Ссылки

Манифесты приложений для решений Office (выпуск 2007 системы Microsoft Office)

Манифесты развертывания для решений Office (система 2007)

Манифест приложения ClickOnce

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

Манифесты приложений для решений Office (выпуск 2007 системы Microsoft Office)

Заметки

Расположение файлов

Синтаксис имени файла

Пример настройки на уровне документа

Описание

Код

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

Описание

Код

См. также

Ссылки

Дополнительные ресурсы