ProjectItem – element (šablony projektů sady Visual Studio)

Článek
10/10/2023

Určuje soubor, který je součástí šablony projektu.

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 pro šablony projektů. Vysvětlení elementu ProjectItem pro šablony položek najdete v tématu ProjectItem – element (šablony položek sady Visual Studio).

Syntaxe

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        FileName.ext
</ProjectItem>

Atributy a prvky

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

Atributy

Atribut	Popis
`TargetFileName`	Nepovinný atribut. Určuje název a cestu položky projektu při vytvoření projektu ze šablony. Tento atribut je užitečný pro vytvoření struktury adresáře, která se liší od struktury adresáře v souboru .zip šablony nebo při použití nahrazení parametru k vytvoření názvu položky.
`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`.
`OpenInEditor`	Nepovinný atribut. Logická hodnota, která určuje, zda má být položka otevřena v příslušném editoru v sadě Visual Studio při vytvoření projektu ze šablony. Atributy `OpenInWebBrowser` jsou `OpenInHelpBrowser` ignorovány u položky s `OpenInEditor` hodnotou `true`. Výchozí hodnota je `false`.
`OpenInWebBrowser`	Nepovinný atribut. Logická hodnota, která určuje, zda má být položka otevřena ve webovém prohlížeči při vytvoření projektu ze šablony. Ve webovém prohlížeči lze otevřít pouze soubory HTML a textové soubory, které jsou v projektu místní. Externí adresy URL nelze otevřít pomocí tohoto atributu. Výchozí hodnota je `false`.
`OpenInHelpBrowser`	Nepovinný atribut. Logická hodnota, která určuje, zda má být položka otevřena v prohlížeči nápovědy při vytvoření projektu ze šablony. V prohlížeči nápovědy lze otevřít pouze soubory HTML a textové soubory, které jsou v projektu místní. Externí adresy URL nelze otevřít pomocí tohoto atributu. Výchozí hodnota je `false`.
`OpenOrder`	Nepovinný atribut. Určuje číselnou hodnotu, která představuje pořadí otevření položek v příslušných editorech. Všechny hodnoty musí být násobky 10. Nejprve se otevřou položky s vyššími `OpenOrder` hodnotami.

Podřízené prvky

Nezaokrouhlovat.

Nadřazené prvky

Element (Prvek)	Popis
Projekt	Určuje soubory nebo adresáře, které se mají přidat do projektu.

Textová hodnota

Je vyžadována textová hodnota.

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

Poznámky

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

Atribut TargetFileName lze použít k vytvoření struktury adresáře, která se liší od struktury adresáře v souboru .zip šablony. Pokud například soubor MyFile.vb existuje v kořenovém adresáři souboru .zip šablony, ale chcete, aby byl soubor umístěn v adresáři s názvem CustomFiles ve všech projektech vytvořených ze šablony, použili byste následující KÓD XML:

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

Atribut TargetFileName lze také použít k přejmenování souborů, které obsahují mezinárodní znaky v jejich souborech. Například soubor .zip šablony nemůže obsahovat názvy souborů s znaky Unicode, takže soubor musí být přejmenován, aby jej bylo možné komprimovat do souboru ZIP. Atribut TargetFileName lze použít k nastavení názvu souboru zpět na původní název souboru Unicode.

Atribut TargetFileName lze také použít k přejmenování souborů s parametry. Následující postup vysvětluje, jak přejmenovat soubor MyFile.vb, který existuje v kořenovém adresáři souboru .zip šablony, na název souboru na základě názvu projektu.

Přejmenování souborů s parametry

V souboru .vstemplate použijte následující kód XML:

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

Otevřete soubor projektu (.vbproj pro projekt jazyka Visual Basic) v textovém editoru nebo sadě Visual Studio.
Vyhledejte řádek v souboru projektu, který vypadá podobně jako následující XML:
```
<Compile Include="MyFile.vb">
```
Řádek kódu nahraďte následujícím kódem XML:
```
<Compile Include="$safeprojectname$.vb">
```
Při vytvoření projektu z této šablony bude název souboru založen na jménu zadaném v dialogovém okně Nový projekt se všemi nebezpečnými znaky a mezerami. Další informace naleznete v tématu Parametry šablony.

Příklad

Následující příklad ukazuje metadata šablony projektu pro aplikaci 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 ReplaceParameters="true">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>

Sdílet prostřednictvím