<appAddin> Element (Office Development in Visual Studio)

Article
07/11/2012

The appAddin element of the vstov4 namespace stores customization-specific information for application-level add-ins.

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

Elements and Attributes

The appAddin element is required and is in the vstov4 namespace. There is only one appAddin element defined in an application manifest.

The appAddin element has the following attributes.

Attribute	Description
application	Required. Identifies the Microsoft Office application. The value can be one of the following: Excel, InfoPath, Outlook, PowerPoint, Project, Visio, or Word.
loadBehavior	Optional. By default, the loadBehavior is enabled by setting this value to . For debugging, the add-in can be disabled by setting the value to two. For more information, see the table titled LoadBehavior Values in Registry Entries for Application-Level Add-Ins.
keyName	Required. This value is the registry key name that will be used by the application to load the add-in. For more information, see Registry Entries for Application-Level Add-Ins.

The appAddin element has the following child elements.

friendlyName

Optional. The friendlyName element is explained in <friendlyName> Element (Office Development in Visual Studio).

description

Optional. The description element is explained in <description> Element (Office Development in Visual Studio).

formRegions

Required only for Outlook application-level add-ins that include form regions. The formRegions element is explained in <formRegions> Element (Office Development in Visual Studio).

Application-Level Add-in Example

Description

The following code example illustrates appAddin elements in an Outlook solution deployed using ClickOnce. This code example is part of a larger example provided in Application Manifests for Office Solutions.

Code

        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook 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>

Share via