Aracılığıyla paylaş


Ş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

  1. Şablon .vstemplate dosyasına yerleştirin ProjectItem parametre değiştirme etkinleştirmek istediğiniz öğeye karşılık gelen öğe.

  2. Set ReplaceParameters özniteliği ProjectItem öğesine true.

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

Ayrıca bkz.

Diğer Kaynaklar

Proje ve madde şablonlarını özelleştirme