Parametry šablony

Článek
06/10/2015

Pomocí parametrů v šablonách lze při vytváření instance šablony nahradit hodnoty nejdůležitějších části šablony, jako jsou názvy tříd a obory názvů.Tyto parametry jsou nahrazeny průvodcem šablony, který běží na pozadí, když uživatel klikne na OK v dialogových oknech Nový projekt nebo Přidat novou položku.

Deklarování a povolování parametrů šablon

Parametry šablon jsou deklarovány ve formátu $parameter$.Příklad:

$safeprojectname$
$guid1$
$guid5$

Povolit záměnu parametrů v šablonách

V souboru .vstemplate šablony nalezněte prvek ProjectItem, který odpovídá položce, pro kterou chcete povolit náhradu parametrů.
Nastavte atribut ReplaceParameters elementu ProjectItem na hodnotu true.
V souboru kódu pro položku projektu zahrňte odpovídající parametry.Například následující parametr určuje, že bezpečný název projektu bude použit pro obor názvů v souboru:
```
namespace $safeprojectname$
```

Vyhrazené parametry šablon

V následující tabulce jsou uvedeny vyhrazené parametry šablon, které mohou použity libovolnou šablonou.

[!POZNÁMKA]

Parametry šablon rozlišují velká a malá písmena.

Parametr	Description
clrversion	Aktuální verze modulu CLR (Common Language Runtime).
GUID [1-10]	Identifikátor GUID je použit k nahrazení identifikátoru GUID projektu v souboru projekt.Můžete zadat až 10 jedinečných identifikátorů GUID (například guid1).
itemname	Název poskytnutý uživatelem v dialogovém okně Přidat novou položku.
machinename	Aktuální název počítače (například Computer01).
projectname	Název poskytnutý uživatelem v dialogovém okně Nový projekt.
registeredorganization	Hodnota klíče registru z HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization.
rootnamespace	Kořenový obor názvů aktuálního projektu.Tento parametr platí pouze pro šablony položek.
safeitemname	Název poskytnutý uživatelem v dialogovém okně Přidat novou položku se všemi nebezpečnými znaky a odstraněnými mezerami.
safeprojectname	Název poskytnutý uživatelem v dialogovém okně Nový projekt se všemi nebezpečnými znaky a odstraněnými mezerami.
time	Aktuální čas ve formátu DD/MM/RRRR 00:00:00
SpecificSolutionName	Název řešení.Pokud je zaškrtnuto políčko „vytvořit adresář řešení“, SpecificSolutionName má název řešení.Pokud není zaškrtnuto políčko „vytvořit adresář řešení“, SpecificSolutionName je prázdné.
userdomain	Aktuální uživatelská doména.
username	Jméno aktuálního uživatele.
webnamespace	Název aktuální webové stránky.Tento parametr je používán ve webové šabloně formuláře tak, aby zaručil jedinečné názvy tříd.Pokud web není v kořenovém adresáři webového serveru, tato šablona parametru se převede do kořenového adresáře z webového serveru.
year	Aktuální rok ve formátu RRRR

Vlastní parametry šablon

Kromě vyhrazených výchozích parametrů šablony lze určit vlastní parametry a hodnoty šablony, které jsou použity při nahrazení parametru. Další informace naleznete v tématu CustomParameters – element (šablony sady Visual Studio).

Příklad: Nahrazení názvů souborů

Je možné zadat různé názvy souborů pro položky projektu pomocí parametru s atributem TargetFileName.Například můžete zadat, že .exe soubor použije název projektu určený $projectname$ jako název souboru.

<TemplateContent>
    <ProjectItem
        ReplaceParameters="true"
        TargetFileName="$projectname$.exe">
            File1.exe
    </ProjectItem>
      ...
</TemplateContent>

Příklad: Použití názvu projektu jako název oboru názvů

Chcete-li použít název projektu pro obor názvů v souboru třídy jazyka Visual C#, Class1.cs, použijte následující syntaxi:

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;

#endregion

namespace $safeprojectname$
{
    public class Class1
        {
            public Class1()
                {

                }
         }
}

V souboru .vstemplate pro šablonu projektu zahrňte následující XML při odkazování na soubor Class1.cs:

<TemplateContent>
    <ProjectItem ReplaceParameters="true">
        Class1.cs
    </ProjectItem>
    ...
</TemplateContent>

Viz také

Další zdroje

Přizpůsobení šablon projektů a položek

Sdílet prostřednictvím