<dependentAssembly> Element (Visual Studio Tools for Office Deployment Reference)

  • 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

  • Microsoft Office 2003

Provides information about dependent assemblies or the application manifest.

<dependentAssembly
    codebase
    size
    >
    <assemblyIdentity
        name
        version
        publicKeyToken
        language
    />
    <hash>
        <dsig:Transforms>
            <dsig:Transform
                Algorithm
            />
        </dsig:Transforms>
        <dsig:DigestMethod
            Algorithm
        />
        <dsig:DigestValue>
    </hash>
</dependentAssembly>

Elements and Attributes

The dependentAssembly element is required. It has the following attributes.

Attribute

Description

codebase

The full path to the application manifest.

size

The size of the application manifest, in bytes.

The dependentAssembly element has the following child elements.

assemblyIdentity

The assemblyIdentity element is described in the topic <assemblyIdentity> Element (Visual Studio Tools for Office Deployment Reference).

hash

The hash element has no attributes.

This is an algorithmic hash of all the files in an application. It is used as a security check, to ensure that none of the files are altered subsequent to deployment.

dsig:Transforms

The dsig:Transforms element is a required child of the hash element. The dsig:Transforms element has no attributes.

dsig:Transform

The dsig:Transform element is a required child of the dsig:Transforms element. The following table shows the attributes of the dsig:Transform element.

Attribute

Description

Algorithm

The algorithm used to calculate the digest for this file.

dsig:DigestMethod

The dsig:DigestMethod element is a required child of the hash element. The following table shows the attributes of the dsig:DigestMethod element.

Attribute

Description

Algorithm

The algorithm used to calculate the digest for this file.

dsig:DigestValue

The dsig:DigestValue element is a required child of the hash element. The dsig:DigestValue element has no attributes. Its text value is the computed hash for the specified file.

Remarks

Application and deployment manifests in Visual Studio Tools for Office solutions are not signed, as ClickOnce manifests are. The manifests cannot be validated before they are used.

Some of the fields in application and deployment manifests that are generated by the publish tools are not used in Visual Studio Tools for Office solutions, including some fields that identify properties of the assembly such as size and version.

Example

The following code example illustrates the dependentAssembly element in a deployment manifest for a Visual Studio Tools for Office solution. This code example is part of a larger example provided for the Deployment Manifests for Office Solutions (2003 System) topic.

<dependency>
    <dependentAssembly 
        codebase="ExcelApplication1_1.0.0.1\ExcelApplication1.manifest"
        size="2518"
        >
        <assemblyIdentity name="ExcelApplication1.manifest" 
            version="1.0.0.1" />
        <hash>
            <dsig:Transforms>
                <dsig:Transform Algorithm=
                    "urn:schemas-microsoft-com:HashTransforms.Identity"
                />
            </dsig:Transforms>
            <dsig:DigestMethod
                Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
            <dsig:DigestValue>
                qws6Ku5WQeMv12bE1W5deGkSHcY=
            </dsig:DigestValue>
        </hash>
    </dependentAssembly>
</dependency>

See Also

Reference

Deployment Manifests for Office Solutions (2003 System)