Parametry šablony

Článek
08/11/2011

Všechny šablony podporují záměnu parametrů k povolení výměny parametrů klíče, jako jsou například názvy tříd a jmenné prostory, když je vytvořena instance šablony. 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 $parametr$. Příklad:

$safeprojectname$
$guid1$
$guid5$

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

V souboru .vstemplate šablony nalezněte element 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	Popis
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 je použit k nahrazení pouze oboru názvů v přidávané položce do projektu.
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.
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

Vedle vyhrazených parametrů šablony, které jsou automaticky použity při nahrazení parametru, můžete zadat vlastní parametry a hodnoty šablony. Další informace naleznete v tématu Postupy: Předat vlastní parametry do šablon.

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

Šablony sady Visual Studio

Sdílet prostřednictvím