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

Статья
06/10/2015

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

<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>