Элемент Project (шаблоны Visual Studio)

Статья
04/10/2024

Указывает файлы или каталоги для добавления в проект.

<Проект VSTemplate><TemplateContent><>

Синтаксис

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

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Description
`File`	Обязательный атрибут элемента . Указывает имя файла проекта в файле шаблона .zip .
`ReplaceParameters`	Необязательный атрибут элемента . Логическое значение, указывающее, имеет ли файл проекта значения параметров, которые необходимо заменить при создании проекта из шаблона. Значение по умолчанию: `false`.
`TargetFileName`	Необязательный атрибут элемента . Указывает имя файла проекта при создании проекта из шаблона.
`IgnoreProjectParameter`	Необязательный атрибут элемента . Указывает, следует ли добавить проект в текущее решение. Если значение настраиваемого параметра "$myCustomParameter$" существует в файле замены параметров, проект создается, но не добавляется в рамках открытого решения.

Дочерние элементы

Элемент	Description
Папка	Необязательный элемент. Указывает папку для добавления в проект.
Projectitem	Необязательный элемент. Указывает файл для добавления в проект.

Родительские элементы

Элемент	Description
TemplateContent	Обязательный элемент.

Замечания

Project — необязательный дочерний элемент элемента TemplateContent.

Элемент Project используется для указания проекта и поэтому является допустимым только в шаблонах проектов.

Projectэлементы могут содержать дочерние элементы папки или дочерние элементы ProjectItem, но не сочетание элементов и ProjectItemFolder дочерних элементов.

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>

Поделиться через