Share via

<customization> Element (2007 System)

  • Article

Note

Applies to

The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office.

For more information, see Features Available by Product Combination.

Project type

  • Document-level projects

  • Application-level projects

Microsoft Office version

  • 2007 Microsoft Office system

The customization element of the vstov3 namespace contains the customization-specific information. The child elements are different for document-level customizations and application-level add-ins.

Syntax for Document-Level Customizations

<customization
    <document
        solutionId
    />
</customization>

Syntax for Application-Level Add-Ins

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

Elements and Attributes

The customization element contains customization-specific information. This element must be in the following namespace: vstov3=urn:schemas-microsoft-com:vsto.v3.

Child elements of the assembly must also be in this namespace, by inheritance or by tagging.

The customization element has no attributes.

Document-Level Customizations

The customization element has the following child element.

document

The document element in the vstov3 namespace is defined in <document> Element (2007 System).

Application-Level Add-Ins

The customization element has the following child element.

appAddin

The appAddin element in the vstov3 namespace is defined in <appAddin> Element (2007 System).

Remarks

You can manually edit application and deployment manifests in Visual Studio Tools for Office solutions. Application and deployment manifests must be re-signed by the Manifest Generation and Editing Tool (mage.exe and mageui.exe) after the manifests are edited. Sign the application manifest first and the deployment manifest next. For more information, see Manifest Generation and Editing Tool (Mage.exe) and Manifest Generation and Editing Tool, Graphical Client (MageUI.exe).

Example of a Document-Level Customization

Description

The following code example illustrates the customization element for a document-level customization. This code example is part of a larger example provided in Application Manifests for Office Solutions (2007 System).

Code

<vstov3:customization
    xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
vstov3:document
    solutionId="989..." />
</vstov3:customization>

Example of an Application-Level Add-In

Description

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

Code

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

See Also

Reference

Application Manifests for Office Solutions (2007 System)

Deployment Manifests for Office Solutions (2007 System)

ClickOnce Application Manifest