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


<элемент настройки> (разработка Office в Visual Studio)

Элемент customization пространства имен vstov4 описывает конкретное решение Office. Дочерние элементы настроек уровня документа и надстроек VSTO отличаются друг от друга.

Синтаксис для настроек на уровне документа

<customization
  id
  <document
    solutionId
  />
</customization>

Синтаксис надстроек VSTO

<customization
  id
  <appAddin
    application
    loadBehavior
    keyName>
  <friendlyName></friendlyName>
  <description></description>
  <formRegions></formRegions>
</customization>

Элементы и атрибуты

Элемент customization содержит сведения о настройках. Этот элемент должен принадлежать следующему пространству имен: vstov4=urn:schemas-microsoft-com:vsto.v4. Существует по одному элементу customization для каждого решения Office. Например, при развертывании трех решений Office в многопроектном развертывании в манифесте приложения будет существовать три элемента customization .

Дочерние элементы сборки также необходимо включить в это пространство имен.

Элемент customization имеет перечисленные ниже атрибуты.

Атрибут Description
id Требуется для многопроектного развертывания. Элемент id уникальным образом идентифицирует решение Office.

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

Элемент customization имеет указанный ниже дочерний элемент.

документ

Элемент document в пространстве имен определяется в <элементе vstov4 document> (разработка Office в Visual Studio).

Надстройки VSTO

Элемент customization имеет указанный ниже дочерний элемент.

appAddin

Элемент appAddin в пространстве имен определен в <элементе vstov4 appAddin> (разработка Office в Visual Studio).

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

Description

В приведенном ниже примере кода показан элемент customization для настройки на уровне документа. Этот пример кода является частью более крупного примера, предоставленного в манифестах приложений для решений Office.

Код

<vstov4:customization>
  <vstov4:document
    solutionId="73e" />
</vstov4:customization>

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

Description

В следующем примере кода показан customization элемент надстройки VSTO. Это надстройка VSTO для Outlook, в которой используются области форм. Этот пример кода является частью более крупного примера, предоставленного в манифестах приложений для решений Office.

Код

<vstov4:customization>
  <vstov4:appAddIn
    application="Outlook"
    loadBehavior="3"
    keyName="ContosoOutlookAddIn">
    <vstov4:friendlyName>
      ContosoOutlookAddIn
    </vstov4:friendlyName>
    <vstov4:description>
      ContosoOutlookAddIn - Outlook VSTO Add-in
      created with Visual Studio Tools for Office
    </vstov4:description>
    <vstov4:formRegions>
      <vstov4:formRegion
          name="OutlookAddIn1.FormRegion1">
        <vstov4:messageClass name="IPM.Note" />
        <vstov4:messageClass name="IPM.Contact" />
        <vstov4:messageClass name="IPM.Appointment" />
      </vstov4:formRegion>
    </vstov4:formRegions>
  </vstov4:appAddIn>
</vstov4:customization>

См. также