<customizations> Element (Office Development in Visual Studio)

  • Article

The customizations element of the vstov4 namespace contains all the information about installing and loading each Office solution.

Syntax for Document-Level Customizations

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

Syntax for Application-Level Add-Ins

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

Elements and Attributes

The customizations element contains specific information about each Office solution. This element must be in the following namespace: vstov4=urn:schemas-microsoft-com:vsto.v4. Child elements of the assembly must also be in this namespace.

The customizations element has no attributes.

The customizations element has the following child element.

customization

Required. The customization element in the vstov4 namespace is defined in <customization> Element (Office Development in Visual Studio).

Example of a Document-Level Customization

Description

The following code example illustrates the customizations element for a document-level customization.

Note

This code example is part of a larger example provided in Application Manifests for Office Solutions.

Code

    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>

Example of an Application-Level Add-In

Description

The following code example illustrates the customizations element for an application-level add-in. This is an Outlook add-in that includes form regions. This code example is part of a larger example provided in Application Manifests for Office Solutions.

Code

    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <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>
      </vstov4:customization>
    </vstov4:customizations>

See Also

Reference

Application Manifests for Office Solutions

Deployment Manifests for Office Solutions

ClickOnce Application Manifest