<addin> 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 Application and Project Type.

Project type

  • Document-level projects

  • Application-level projects

Microsoft Office version

  • 2007 Microsoft Office system

The addin element of the vstav2 namespace contains Visual Studio Tools for Office and Microsoft Office application-specific information.

<addIn>
    <entryPoints>
        <entryPoint>
        </entryPoint>
    </entryPoints>
    <update></update>
    <application>
        <customization>
        </customization>
    </application
</addIn>

Elements and Attributes

The addin element of the vstav2 namespace contains information about the Visual Studio Tools for Office solution and the Microsoft Office application. This element must be in the following namespace: vstav2=urn:schemas-microsoft-com:vsta.v2. Child elements must also be in this namespace.

The addin element has no attributes.

The addin element has the following child elements.

entryPoints

Required. The entryPoints element is described in <entryPoints> Element (2007 System).

update

Required. The update element is described in <update> Element (2007 System).

application

Required. The application element is described in <application> 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).

Document-Level Customization Example

Description

The following code example illustrates the addin element in a document-level Visual Studio Tools for Office solution deployed by using ClickOnce. This code example is part of a larger example provided in Application Manifests for Office Solutions (2007 System).

Code

<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
        <vstov3:document
            solutionId="989..." />
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

Application-Level Add-in Example

Description

The following code example illustrates the addin element in an application-level Visual Studio Tools for Office solution deployed by using ClickOnce. This code example is part of a larger example provided in Application Manifests for Office Solutions (2007 System).

Code

<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
            <assemblyIdentity
                name="OutlookAddIn1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <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>
    </vstav2:application>
</vstav2:addIn>

See Also

Reference

Application Manifests for Office Solutions (2007 System)

Deployment Manifests for Office Solutions (2007 System)

ClickOnce Application Manifest