<RelatedProducts> Element (Bootstrapper)

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2019. 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>  

See Also

<Product> Element