<RelatedProducts> element (bootstrapper)

Article
11/04/2016

Applies to: Visual Studio Visual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

The RelatedProducts element defines other products that either depend upon or are included in the current product.

Syntax

<RelatedProducts>
    <DependsOnProduct
        Code
    />
    <EitherProducts>
        <DependsOnProduct
            Code
        />
    </EitherProducts>
    <IncludesProduct
        Code
    />
</RelatedProducts>

Elements and attributes

The RelatedProducts element is a child of the Product element. It has no attributes.

DependsOnProduct

The DependsOnProduct element signifies that the current product depends upon the named product, and that the named product should be installed before the current one. It is a child of the RelatedProducts element. A RelatedProducts element might have one or more DependsOnProduct elements.

DependsOnProduct has the following attribute.

Attribute	Description
`Code`	The code name of the included product, as specified by the `ProductCode` attribute of the `Product` element. For more information, see <Product> Element.

EitherProducts

The EitherProducts element defines zero or more DependsOnProduct elements, and has no attributes. At least one DependsOnProduct in this set must be installed before the current product. A RelatedProducts element can have zero or more EitherProducts elements.

IncludesProduct

The IncludesProduct element signifies that a product is included with the current install, and does not require a separate installation. It is a child of the RelatedProducts element. A RelatedProducts element might have one or more IncludesProduct elements.

IncludesProduct has the following attribute.

Attribute	Description
`Code`	The code name of the included product, as specified by the `ProductCode` attribute of the `Product` element. For more information, see <Product> Element.

Example

The following code example specifies that the Microsoft Installer is installed with the .NET Framework, and therefore will not need a separate installation.

<RelatedProducts>
    <IncludesProduct Code="Microsoft.Windows.Installer.2.0" />
</RelatedProducts>