MaxFrameworkVersion element (Visual Studio templates)

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

Specifies the maximum version of the .NET Framework that is required by the template. It determines the highest value available in the Target Framework Version dropdown of the New Project dialog. In order for users to be able to select a framework version, you must also specify RequiredFrameworkVersion as the minimum .NET Framework version for the template.

Important

Starting in Visual Studio 2017 version 15.6, the Target Framework Version dropdown is no longer a filter for displayed templates in the Templates section of the New Project dialog. Instead, the Target Framework Version dropdown functions as a framework picker for the selected template.

Syntax

<MaxFrameworkVersion> ... </MaxFrameworkVersion>

Attributes and elements

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

Attributes

None.

Child elements

None.

Parent elements

Element	Description
TemplateData	Required element. Categorizes the template and defines how it is displayed in either the New Project or the Add New Item dialog box.

Text value

A text value is required.

The text must be the highest version number of the .NET Framework that is allowed by the template.

Remarks

MaxFrameworkVersion is an optional element. The MaxFrameworkVersion element should be omitted unless it is required, so as not to inadvertently limit the supported range of .NET Framework versions for the template. It should also be omitted if .NET Framework is not applicable to the template.

Example

The following example illustrates the metadata for a standard Visual C# class template.

<VSTemplate Type="Item" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class template.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <RequiredFrameworkVersion>3.0</RequiredFrameworkVersion>
        <MaxFrameworkVersion>4.7.1</MaxFrameworkVersion>
        <DefaultName>MyClass</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem>MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>

In this example, the maximum version of the .NET Framework that is required by the template, represented by MaxFrameworkVersion, is 4.7.1. A project created with this template can target .NET Framework versions up to 4.7.1.

Share via