<appAddin> Element (Office Development in Visual Studio)

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>

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.

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

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

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).

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.

        <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>
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft