Şablon Parametreleri
Şablon örneği başlatıldığında şablonlarınızı parametreleri kullanarak, sınıf adları ve ad alanlarında, şablon anahtar kısımlarını değerlerini değiştirebilirsiniz.Bu parametreler, kullanıcı tıklattığında, arka planda çalışır Şablon Sihirbazı tarafından değiştirilir Tamam , Yeni bir proje veya Add New Item iletişim kutuları.
Bildirmek ve şablon parametrelerini etkinleştirme
Şablon parametreleri biçimi $ içinde bildirilenparametresi$.Örne?in:
$safeprojectname$
$guid1$
$guid5$
Parametre değiştirme şablonlarında etkinleştirmek için
Şablon .vstemplate dosyasına yerleştirin ProjectItem parametre değiştirme etkinleştirmek istediğiniz öğeye karşılık gelen öğe.
Set ReplaceParameters özniteliği ProjectItem öğesine true.
Proje öğesi kod dosyasında, uygun olan yerlerde parametreleri içerir.Örneğin, aşağıdaki parametre güvenli proje adı ad alanında bir dosya için kullanılması gerektiğini belirtir:
namespace $safeprojectname$
Ayrılmış şablon parametreleri
Herhangi bir şablon tarafından kullanılan ayrılmış şablon parametreleri aşağıdaki tabloda listelenmektedir.
[!NOT]
Şablon parametreleri büyük/küçük harfe duyarlıdır.
Parametre |
Tanımlama |
---|---|
clrversion |
Ortak dil çalışma zamanı (clr) geçerli sürümü. |
GUID [1-10] |
Projeyi project dosyasındaki GUID değiştirmek için kullanılan bir GUID.En fazla 10 benzersiz GUID değerlerini belirtebilirsiniz (örneğin, guid1). |
itemname |
Kullanıcı tarafından sağlanan adı Add New Item iletişim kutusu. |
machinename |
Geçerli bilgisayar adı (örneğin, Computer01). |
projectname |
Kullanıcı tarafından sağlanan adı Yeni bir proje iletişim kutusu. |
registeredorganization |
Kayıt defteri anahtar değer HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization. |
rootnamespace |
Geçerli projenin kök ad alanı.Bu parametre yalnızca öğe şablonları için geçerlidir. |
safeitemname |
Kullanıcı tarafından sağlanan adı Add New Item iletişim kutusunda, tüm güvenli olmayan karakterleri ve boşlukları kaldırıldı. |
safeprojectname |
Kullanıcı tarafından sağlanan adı Yeni bir proje iletişim kutusunda, tüm güvenli olmayan karakterleri ve boşlukları kaldırıldı. |
time |
AA/GG/yyyy biçiminde geçerli saati 00: 00: 00. |
SpecifiedSolutionName |
Çözüm adı. |
userdomain |
Geçerli kullanıcının etki alanı. |
username |
Geçerli kullanıcı adı. |
webnamespace |
Geçerli Web sitesinin adı.Bu parametre Web form şablonunun benzersiz sınıf adları güvence altına almak için kullanılır.Web sitesi Web sunucusunun kök dizininde ise, bu şablon parametresi Web sunucusu kök dizininin giderir. |
year |
yyyy biçiminde geçerli yıl. |
Özel şablon parametreleri
Kendi şablon parametreleri ve değerleri, parametre değiştirme sırasında kullanılan ayrılmış varsayılan şablon parametrelere ek olarak belirtebilirsiniz.Daha fazla bilgi için bkz:CustomParameters öğesi (Visual Studio şablonları)
Örnek: Dosya adlarını değiştirme
Parametresiyle birlikte kullanarak, proje öğeleri için değişken dosya adları belirtebilirsiniz TargetFileName özniteliği.Örneğin, .exe dosyası tarafından belirtilen proje adı kullanmasını belirtebilirsiniz $projectname$, dosya adı olarak.
<TemplateContent>
<ProjectItem
ReplaceParameters="true"
TargetFileName="$projectname$.exe">
File1.exe
</ProjectItem>
...
</TemplateContent>
Örnek: Proje adı ad alanı adı için kullanma
Proje adı ad alanı için bir Visual C# sınıf dosyasında, Class1.cs, kullanmak için aşağıdaki sözdizimini kullanın:
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
#endregion
namespace $safeprojectname$
{
public class Class1
{
public Class1()
{
}
}
}
Class1.cs dosyası başvuru yaptığınızda proje şablonu .vstemplate dosyasına aşağıdaki xml içerir:
<TemplateContent>
<ProjectItem ReplaceParameters="true">
Class1.cs
</ProjectItem>
...
</TemplateContent>