Dependency Element (VSX Schema)

Article
09/12/2011

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Describes a package that another package depends on. If a dependency package is specified (that is, identified by its Metadata Element Id attribute), it must already be installed before this package is installed; otherwise, this package must install it.

<Dependency Id="Microsoft.Framework.NDP" Version="[4.0-5.0)" CanAutoDownload="false" IsRequired="true" />

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
Id	Required. The unique identifier for the dependency package. Must match the Id attribute of the Metadata Element of the dependency package.
Version	Required. The allowable version range of the dependency package. The version range notation is : [1.0 – 2.1). A leading left square bracket means the minimum version is inclusive. A trailing right square bracket means the maximum version is inclusive. A leading left parenthesis means the minimum version is exclusive. A trailing right parenthesis means the maximum version is exclusive. A single version number selects a minimum supported version that has an unbounded maximum.
DisplayName	The display name of the dependent package. Used in user-interface elements such as dialog boxes and error messages. Required for MSI-based dependencies, or when the CanAutoDownload attribute is set to false. Otherwise, this attribute is optional.
Location	Optional. Specifies either the relative path of a nested dependency package or the URL of the download location for the dependency package. Use this attribute if you want to limit download location or if the dependency package is installed by an MSI-based installer.
Attributes	Adds an open-ended set of attributes that are exposed at run time as a name-value pair dictionary.

Child Elements

Element	Description
None

Parent Elements

Element	Description
Dependencies Element	Contains a list of Dependency Elements for the dependent package.

Remarks

Any attributes that are not listed in this document are exposed to the VSIX Manifest API as a name-value pair dictionary.

Element Information

Namespace	https://schemas.microsoft.com/developer/vsx-schema/2011
Schema Name	VSIX Manifest
Validation File	PackageManifestSchema.xsd
Can be Empty	Not applicable