Project, element (szablony programu Visual Studio)

Artykuł
01/13/2024

Określa pliki lub katalogi, które mają zostać dodane do projektu.

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybut, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	opis
`File`	Atrybut wymagany. Określa nazwę pliku projektu w pliku .zip szablonu.
`ReplaceParameters`	Atrybut opcjonalny. Wartość logiczna określająca, czy plik projektu ma wartości parametrów, które należy zamienić podczas tworzenia projektu na podstawie szablonu. Wartość domyślna to `false`.
`TargetFileName`	Atrybut opcjonalny. Określa nazwę pliku projektu podczas tworzenia projektu na podstawie szablonu.
`IgnoreProjectParameter`	Atrybut opcjonalny. Określa, czy projekt ma zostać dodany do bieżącego rozwiązania. Jeśli wartość parametru niestandardowego "$myCustomParameter$" istnieje w pliku zastępczym parametru, projekt zostanie utworzony, ale nie zostanie dodany jako część aktualnie otwartego rozwiązania.

Elementy podrzędne

Element	opis
Folder	Element opcjonalny. Określa folder do dodania do projektu.
Projectitem	Element opcjonalny. Określa plik do dodania do projektu.

Elementy nadrzędne

Element	opis
Templatecontent	Element wymagany.

Uwagi

Project jest opcjonalnym elementem podrzędnym elementu TemplateContent.

Element Project jest używany do określania projektu, dlatego jest prawidłowy tylko w szablonach projektów.

Project elementy mogą zawierać elementy podrzędne folderu lub elementy podrzędne ProjectItem , ale nie kombinację elementów podrzędnych i FolderProjectItem elementów podrzędnych.

Program Visual Studio automatycznie zmienia nazwę pliku projektu na podstawie nazwy wprowadzonej przez użytkownika w oknie dialogowym Nowy projekt . Użyj atrybutu TargetFileName , jeśli chcesz podać alternatywną nazwę pliku dla plików projektu utworzonych za pomocą szablonu.

Przykład

Poniższy przykład przedstawia metadane szablonu projektu dla aplikacji 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>

Share via