Parametry szablonu

Artykuł
03/22/2013

Przy użyciu parametrów w szablonach, możesz zastąpić wartości kluczowych części szablonu, na przykład nazwy klas i obszary nazw, przy tworzeniu wystąpienia szablonu.Parametry te są zastępowane przez Kreatora szablonów, który działa w tle, gdy użytkownik kliknie OK w Nowy projekt lub Add New Item okna dialogowe.

Deklarowanie i włączanie parametrów szablonu

Parametry szablonu są deklarowane w format parametr$.Na przykład:

$safeprojectname$
$ $guid1
$ $guid5

Aby włączyć Podstawienie parametru w szablonach

W pliku .vstemplate szablonu, należy zlokalizować ProjectItem element, który odpowiada element, dla którego chcesz włączyć zastępczego parametru.
Ustaw ReplaceParameters atrybut ProjectItem element, aby true.
W pliku kodu dla elementu projektu zawiera parametry, gdzie stosowne.Na przykład następujący parametr określa, że nazwa bezpiecznego projektu używać dla obszaru nazw w pliku:
```
namespace $safeprojectname$
```

Zastrzeżone parametrów szablonu

Poniższa lista zawiera parametry szablonu zarezerwowanych, które mogą być używane przez dowolny szablon.

[!UWAGA]

Parametry szablonu jest rozróżniana wielkość liter.

Parametr	Opis
clrversion	Aktualna wersja plików wykonywalnych języka wspólnego (CLR).
GUID [1-10]	Identyfikator GUID służący do zastąpienia projektu identyfikator GUID w pliku projektu.Można określić maksymalnie 10 unikatowych identyfikatorów GUID (na przykład, guid1).
itemname	Nazwa wprowadzona przez użytkownika w Add New Item okno dialogowe.
machinename	Bieżąca nazwa komputera (na przykład Computer01).
projectname	Nazwa wprowadzona przez użytkownika w Nowy projekt okno dialogowe.
registeredorganization	Wartość klucza rejestru z HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization.
rootnamespace	Głównego obszaru nazw bieżącego projektu.Ten parametr dotyczy tylko szablony elementów.
safeitemname	Nazwa wprowadzona przez użytkownika w Add New Item okno dialogowe, ze wszystkimi niebezpieczny litery i usunięte spacje.
safeprojectname	Nazwa wprowadzona przez użytkownika w Nowy projekt okno dialogowe, ze wszystkimi niebezpieczny litery i usunięte spacje.
time	Bieżący czas w formacie DD/MM/RRRR 00: 00: 00.
SpecifiedSolutionName	Nazwę rozwiązania.
userdomain	Bieżąca domena użytkownika.
username	Nazwę bieżącego użytkownika.
webnamespace	Nazwa bieżącej witryny sieci Web.Ten parametr jest używany w szablonie formularza sieci Web do zagwarantowania nazwy klas unikatowy.Jeśli witryna sieci Web jest w katalogu głównym serwera sieci Web, katalogu głównym serwera sieci Web rozpoznawany jako ten parametr szablonu.
year	Bieżącego roku w formacie rrrr.

Niestandardowe parametry szablonu

Można określić własne parametry szablonu i wartości, oprócz parametrów szablonu domyślnego zastrzeżone, używanych podczas wymiany parametru.Aby uzyskać więcej informacji zobaczElement CustomParameters (Visual Studio szablonów)

Przykład: Zastąpienie nazwy plików

Można określić nazwy zmiennej plików dla elementów projektu przy użyciu parametru z TargetFileName atrybut.Na przykład, można określić, że plik .exe użyć nazwy projektu, określonej przez $projectname$, jak nazwa pliku.

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

Przykład: Przy użyciu nazwy projektu dla nazwy obszaru nazw

Aby użyć nazwy projektu dla obszaru nazw w środowisku Visual C# plik klasy, Class1.cs, należy użyć następującej składni:

#region Using directives

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

#endregion

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

                }
         }
}

W pliku .vstemplate dla szablonu projektu należy uwzględnić następujące XML podczas odwołać pliku Class1.cs:

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

Zobacz też

Inne zasoby

Dostosowywanie projektu i szablony zapasów

Udostępnij za pośrednictwem