Project 元素（Visual Studio 模板）

2013-02-24

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

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

特性和元素

以下几节描述了特性、子元素和父元素。

特性

特性	描述
File	必需的特性。指定 .zip 模板文件中此项目文件的名称。
ReplaceParameters	可选特性。一个布尔值，该值指定从此模板创建项目时此项目文件是否具有必须替换的参数值。默认值为 false。
TargetFileName	可选特性。指定从此模板创建项目时此项目文件的名称。
IgnoreProjectParameter	可选特性。指定是否应将项目添加到当前解决方案中。如果自定义参数的值，“$myCustomParameter$”存在参数替换文件，作为当前打开的解决方案的一部分，将创建项目，但不会添加。

子元素

元素	描述
文件夹	可选元素。指定要添加到此项目的文件夹。
ProjectItem	可选元素。指定要添加到某个项目中的文件。

文件夹

可选元素。

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

ProjectItem

可选元素。

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

父元素

元素	描述
TemplateContent	必需的元素。

备注

Project 是 TemplateContent 的可选子元素。

Project 元素用于指定一个项目，因此，它只有在项目模板中才有效。

Project 元素可以具有 Folder 子元素或 ProjectItem 子元素，但它不是 Folder 和 ProjectItem 这两种子元素的混合体。

Visual Studio 根据用户在**“新建项目”**对话框中输入的名称自动重命名此项目文件。如果希望为使用此模板创建的项目文件提供一个替换文件名，请使用 TargetFileName 特性。

示例

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

<VSTemplate Type="Project" Version="3.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>