CustomParameter Element (Visual Studio Templates)

Article
11/15/2016

Note

This article applies to Visual Studio 2015. 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

Contains a custom parameter name and value to use when a project or item is created from the template.

Syntax

<CustomParameter Name="name" Value="value">

Attributes and Elements

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

Attributes

Attribute	Description
`Name`	Required. The name of the parameter. The format for parameters is $name$.
`Value`	Required. The replacement value for the parameter.

Child Elements

None.

Parent Elements

Element	Description
CustomParameters	Groups the custom parameters that are to be passed to the template wizard when the wizard makes parameter replacements.

Remarks

When a template contains CustomParameter elements, every instance the Name attribute is replaced with the Value attribute in the created project or item files.

Example

The following example shows how to use several custom parameters in a template. When a project or item is created from a template with the following custom parameters, all instances of $color1$ and $color2$ in the template files will be replaced with Red and Blue, respectively.

<CustomParameters>  
    <CustomParameter Name="$color1$" Value="Red"/>  
    <CustomParameter Name="$color2$" Value="Blue "/>  
</CustomParameters>

Share via