Project 元素 (Visual Studio 模板)

指定要添加到项目的文件或目录。

<VSTemplate><TemplateContent><项目>

语法

<Project
    File="MyProject.proj"
    TargetFileName="MyTargetProject.proj"
    ReplaceParameters="true/false">
    IgnoreProjectParameter="$myCustomParameter$"
        ...
</Project>

特性和元素

以下各部分描述了特性、子元素和父元素。

特性

属性 描述
File 必需的特性。

指定模板.zip文件中项目文件的名称。
ReplaceParameters 可选特性。

一个布尔值,该值指定项目文件是否具有从模板创建项目时必须替换的参数值。 默认值是 false
TargetFileName 可选特性。

指定从模板创建项目时项目文件的名称。
IgnoreProjectParameter 可选特性。

指定是否应将项目添加到当前解决方案。 如果自定义参数的值“$myCustomParameter$”存在于参数替换文件中,则会创建项目,但不添加为当前打开的解决方案的一部分。

子元素

元素 说明
文件夹 可选元素。

指定要添加到项目的文件夹。
ProjectItem 可选元素。

指定要添加到项目的文件。

父元素

元素 说明
TemplateContent 必需的元素。

注解

ProjectTemplateContent 的可选子元素。

Project 元素用于指定项目,因此仅在项目模板中有效。

Project元素可以具有 Folder 子元素或 ProjectItem 子元素,但不能同时包含子Folder元素和ProjectItem子元素。

Visual Studio 根据用户在 “新建项目 ”对话框中输入的名称自动重命名项目文件名。 如果要为使用模板创建的项目文件提供备用文件名,请使用该 TargetFileName 属性。

示例

下面的示例说明了 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>

另请参阅