TemplateData 元素(Visual Studio 模板)

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

<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

可选元素。

指定是否可以将项目创建为临时项目。

EnableLocationBrowseButton

可选元素。

指定“新建项目”对话框中是否有“浏览”按钮,使用户可以轻松地修改保存新项目的默认目录。

Hidden

可选元素。

指定模板是否出现在“新建项目”“添加新项”对话框中。

NumberOfParentCategoriesToRollUp

可选元素。

指定将在“新建项目”对话框中显示此模板的父类别的数目。

LocationFieldMRUPrefix

可选元素。

LocationField

可选元素。

指定对于此项目模板,是启用、禁用还是隐藏“新建项目”对话框中的“位置”文本框。

RequiredFrameworkVersion

可选元素。

如果模板仅支持特定的 .NET Framework 最低版本和更高版本(如果有),则使用此元素。

SupportsMasterPage

可选元素。

指定模板是否支持 Web 项目的母版页。

SupportsCodeSeparation

可选元素。

指定模板是否支持 Web 项目的代码分隔或代码隐藏页模型。

SupportsLanguageDropDown

可选元素。

指定多种语言的此模板是否相同,并指定是否在“新建项目”对话框中启用“语言”选项。

父元素

元素

说明

VSTemplate

必选的元素。

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

备注

TemplateData 是必选元素。

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

示例

下面的示例演示针对 Visual C# 应用程序的某个项目模板的元数据。

<VSTemplate Type="Project" Version="2.0.0"
    xmlns="https://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>

请参见

参考

Visual Studio 模板架构参考

其他资源

Visual Studio 模板