ProjectItem – element (šablony položek sady Visual Studio)

Článek
01/13/2024

Určuje soubor, který je součástí šablony položky.

Poznámka:

Element ProjectItem přijímá různé atributy v závislosti na tom, zda je šablona pro projekt nebo položku. Toto téma vysvětluje ProjectItem prvek položky. Vysvětlení elementu ProjectItem pro šablony projektu najdete v tématu ProjectItem – element (šablony projektů sady Visual Studio).>

Syntaxe

<ProjectItem
    SubType="Form/Component/CustomControl/UserControl"
    CustomTool="string"
    ItemType="string"
    ReplaceParameters="true/false"
    TargetFileName="TargetFileName.ext">
        FileName.ext
</ProjectItem>

Atributy a prvky

Následující oddíly popisují atributy a podřízené a nadřazené elementy.

Atributy

Atribut	Popis
`SubType`	Nepovinný atribut. Určuje podtyp položky v šabloně položky s více soubory. Tato hodnota se používá k určení editoru, který Sada Visual Studio použije k otevření položky.
`CustomTool`	Nepovinný atribut. Nastaví CustomTool pro položku v souboru projektu.
`ItemType`	Nepovinný atribut. Nastaví itemType položky v souboru projektu.
`ReplaceParameters`	Nepovinný atribut. Logická hodnota, která určuje, zda položka obsahuje hodnoty parametrů, které musí být nahrazeny při vytvoření projektu ze šablony. Výchozí hodnota je `false`.
`TargetFileName`	Nepovinný atribut. Určuje název položky vytvořené ze šablony. Tento atribut je užitečný pro vytvoření názvu položky pomocí nahrazení parametru.

Podřízené prvky

Nezaokrouhlovat.

Nadřazené prvky

Element (Prvek)	Popis
TemplateContent	Určuje obsah šablony.

Textová hodnota

Je vyžadována textová hodnota.

Astring, který představuje název souboru v souboru .zip šablony.

Poznámky

ProjectItem je volitelná podřízená položka TemplateContent.

Atribut TargetFileName lze použít k přejmenování souborů s parametry. Pokud například soubor MyFile.vb existuje v kořenovém adresáři souboru .zip šablony, ale chcete, aby byl soubor pojmenován na základě názvu souboru zadaného uživatelem v dialogovém okně Přidat novou položku, použili byste následující KÓD XML:

<ProjectItem TargetFileName="$fileinputname$.vb">MyFile.vb</ProjectItem>

Při vytvoření položky z této šablony bude název souboru založen na jménu, které uživatel zadal v dialogovém okně Přidat novou položku . To je užitečné při vytváření šablon položek s více soubory. Další informace naleznete v tématu Postupy: Vytváření šablon položek s více soubory a parametrů šablony.

Příklad

Následující příklad znázorňuje metadata standardní šablony položky pro třídu Visual C#.

<VSTemplate Type="Item" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <DefaultName>MyClass.cs</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem ReplaceParameters="true">MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>

Share via