通过

TemplateData 元素（Visual Studio 模板）

  • 项目

将此模板分类并定义此模板在 “新建项目” 或 “添加新项” 对话框中的显示方式。

<VSTemplate><TemplateData>

语法

<TemplateData>
    <Name> ... </Name>
    <Description> ... </Description>
    <Icon> ... </Icon>
    <ProjectType> ... </ProjectType>
    ...
</TemplateData>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

无。

子元素

元素 说明
Name 必需的元素。

指定模板的名称，因为它显示在 “新建项目 ”或 “添加新项 ”对话框中。
描述 必需的元素。

指定模板的说明，因为它显示在 “新建项目 ”或 “添加新项 ”对话框中。
图标 必需的元素。

指定用作模板的“新建项目”或“添加新项”对话框中显示的图标的图像文件的路径和文件名。
ProjectType 必需的元素。

对项目模板进行分类，使其显示在“新建项目”对话框中的指定组下。
ProjectSubType 可选元素。

对项目模板进行分类，使其显示在“新建项目”对话框中的指定子类别下。
TemplateID 可选元素。

指定模板 ID。
TemplateGroupID 可选元素。

指定模板组 ID。
SortOrder 可选元素。

指定一个值，该值用于将模板排列在同一类别中的其他模板中，因为它显示在 “新建项目 ”或 “添加新项 ”对话框中。
CreateNewFolder 可选元素。

指定是否在项目实例化时创建包含文件夹。
DefaultName 可选元素。

指定在创建项目或项时 Visual Studio 项目系统将生成的名称。
ProvideDefaultName 可选元素。

指定创建项目时 Visual Studio 项目系统是否会为项目或项生成默认名称。
PromptForSaveOnCreation 可选元素。

指定是否可以将项目创建为临时项目（仅 Visual Studio 2017）。
EnableLocationBrowseButton 可选元素。

指定“新建项目”对话框中是否提供了“浏览”按钮，以便用户可以轻松修改保存新项目的默认目录。
Hidden 可选元素。

指定模板是出现在 “新建项目 ”还是 “添加新项 ”对话框中。
NumberOfParentCategoriesToRollUp 可选元素。

指定将在“新建项目”对话框中显示模板的父类别数。
LocationFieldMRUPrefix 可选元素。
LocationField 可选元素。

指定是否为项目模板启用、禁用或隐藏“新建项目”对话框中的“位置”文本框。
RequiredFrameworkVersion 可选元素。

如果模板仅支持特定最低版本以及更高版本的 .NET Framework，请使用此元素。
SupportsMasterPage 可选元素。

指定模板是否支持 Web 项目的母版页。
SupportsCodeSeparation 可选元素。

指定模板是支持 Web 项目的代码分离还是代码隐藏页面模型。
SupportsLanguageDropDown 可选元素。

指定模板是否与多种语言相同，以及“新建项目”对话框中是否提供语言选项。
TargetPlatformName 可选元素。

指定项目模板面向的平台。 此元素指定项目模板用于创建 Windows 8.x 应用商店应用。

父元素

元素 说明
VSTemplate 必需的元素。

包含项目模板、项模板或初学者工具包的所有元数据。

备注

TemplateData 是必需元素。

如果未包含可选元素，则使用该元素的默认值。

示例

下面的示例说明了 Visual C# 应用程序的项目模板的元数据。

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

另请参阅