ProjectItem – element (šablony projektů Visual Studio)

Článek
06/10/2015

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

[!POZNÁMKA]

ProjectItem Element přijímá různé atributy podle toho, zda je šablona projektu nebo položky.Toto téma vysvětluje ProjectItem element pro šablony projektu.Vysvětlení ProjectItem element pro šablony položek, viz ProjectItem – element (šablony položek sady Visual Studio).

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

Atributy a elementy

Následující oddíly popisují atribut, podřízené elementy a rodičovské elementy.

Atributy

Atribut	Description
TargetFileName	Nepovinný atribut. Určuje název a cestu položky projektu při vytvoření projektu z šablony.Tento atribut je užitečné pro vytvoření adresářové struktury, liší od adresářové struktury .zip soubor šablony nebo vytvoření názvu položky pomocí náhrada parametru.
ReplaceParameters	Nepovinný atribut. Logická hodnota, která určuje, zda má položka hodnoty parametrů, které musí být nahrazeny při vytvoření projektu z šablony.Výchozí hodnota je false.
OpenInEditor	Nepovinný atribut. Logická hodnota, která určuje, zda položky by měly být otevřeny ve svých editoru v Visual Studio při vytvoření projektu z šablony. OpenInWebBrowser a OpenInHelpBrowser atributy jsou ignorovány na položky s OpenInEditor hodnoty true. Výchozí hodnota je false.
OpenInWebBrowser	Nepovinný atribut. Logická hodnota, která určuje, zda položky by měly být otevřeny webového prohlížeče při vytvoření projektu z šablony. Pouze soubory HTML a textové soubory, které jsou místní projekt lze otevřít ve webovém prohlížeči.Externí adresy URL nelze otevřít s tímto atributem. Výchozí hodnota je false.
OpenInHelpBrowser	Nepovinný atribut. Logická hodnota, která určuje, zda zboží by měl být otevřen v prohlížeči nápovědy při vytvoření projektu z šablony. Pouze soubory HTML a textové soubory, které jsou místní projekt lze otevřít v prohlížeči nápovědy.Externí adresy URL nelze otevřít s tímto atributem. Výchozí hodnota je false.
OpenOrder	Nepovinný atribut. Určuje číselnou hodnotu, která představuje pořadí, položky budou otevřeny v jejich příslušných editorech.Všechny hodnoty musí být násobkem 10.Položky s vyšší OpenOrder otevřel hodnoty.

Podřízené elementy

Žádný

Nadřazené elementy

Element	Description
Project	Určuje soubory nebo adresáře přidat do projektu.

Textová hodnota

Je požadována hodnota text.

A string , která představuje název nebo cesta do souboru .zip soubor šablony.

Poznámky

ProjectItemje volitelným podřízeným Project.

TargetFileName Atribut lze použít k vytvoření adresářové struktury liší od adresářové struktury v .zip soubor šablony.Například pokud soubor MyFile.vb v kořenovém adresáři .zip soubor šablony existuje, ale chcete soubor umístěn v adresáři s názvem CustomFiles v všechny projekty vytvořené ze šablony, můžete použít následující kód XML:

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

TargetFileName Atribut lze také přejmenovat soubory, které obsahují mezinárodní znaky v názvech souborů, jejich.Například .zip soubor šablony nemůže obsahovat znaky Unicode názvy souborů, takže před mohou být komprimovány do .zip souboru, je nutné přejmenovat soubor.TargetFileName Atribut lze nastavit název souboru zpět na původní název souboru ve formátu Unicode.

TargetFileName Atribut lze použít také 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 .zip soubor šablony k názvu souboru, který je založen na 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 Visual Basic projektu) v textovém editoru nebo Visual Studio.
Vyhledejte řádek v souboru projektu, který vypadá podobně jako následující kód XML:
```
<Compile Include="MyFile.vb">
```
Řádek kódu nahraďte následující kód XML:
```
<Compile Include="$safeprojectname$.vb">
```
Při vytvoření projektu z této šablony, název souboru bude založena na jméno uživatele zadané v Nový projekt dialogovém se všemi nebezpečnými znaky a odstraněnými mezerami.Další informace naleznete v tématu Parametry šablony.

Příklad

Následující příklad zobrazuje metadata pro šablonu projektu Visual C# aplikace.

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