Share via

Öğe şablonları oluşturma

  • Makale

Bu makalede, Şablonu Dışarı Aktarma Sihirbazı'nı kullanarak bir öğe şablonunun nasıl oluşturulacağı gösterilmektedir. Şablonunuz birden çok dosyadan oluşacaksa bkz . Nasıl yapılır: Çok dosyalı öğe şablonları oluşturma.

Yeni Öğe Ekle iletişim kutusuna öğe şablonu ekleme

  1. Visual Studio'da proje oluşturun veya açın.

  2. Projeye bir öğe ekleyin ve isterseniz öğeyi değiştirin.

  3. Parametre değiştirmenin nerede gerçekleşmesi gerektiğini belirtmek için kod dosyasını değiştirin. Daha fazla bilgi için bkz . Nasıl yapılır: Şablondaki parametreleri değiştirme.

  4. Proje menüsünde Şablonu Dışarı Aktar'ı seçin.

  5. Şablon Türü Seç sayfasında Öğe Şablonu'na tıklayın, öğeyi içeren projeyi seçin ve ardından İleri'ye tıklayın.

  6. Dışarı Aktaracak Öğeyi Seç sayfasında, şablon oluşturmak istediğiniz öğeyi seçin ve ardından İleri'yi seçin.

  7. Öğe Başvurularını Seç sayfasında, şablona eklenecek derleme başvurularını seçin ve ardından İleri'yi seçin.

  8. Şablon Seçeneklerini Seç sayfasında şablon adını ve isteğe bağlı açıklamayı, simge görüntüsünü ve önizleme görüntüsünü girin ve son'u seçin.

    Şablonun dosyaları bir .zip dosyasına eklenir ve sihirbazda belirttiğiniz dizine kopyalanır. Varsayılan konum: %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

  9. Şablonu Dışarı Aktarma Sihirbazı'nda Şablonu Visual Studio'ya otomatik olarak aktar seçeneğini belirlemediyseniz, dışarı aktarılan şablonu bulun. Ardından, bunu kullanıcı öğesi şablonu dizinine kopyalayın. Varsayılan konum: %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

  10. Visual Studio'yu kapatın ve yeniden açın.

  11. Yeni bir proje oluşturun veya var olan bir projeyi açın ve ardından Proje>Yeni Öğe Ekle'yi seçin veya Ctrl+Shift A tuşlarına+basın.

    Öğe şablonu Yeni Öğe Ekle iletişim kutusunda görünür. Şablonu Dışarı Aktarma Sihirbazı'na bir açıklama eklediyseniz, açıklama iletişim kutusunun sağ tarafında görüntülenir.

Evrensel Windows Uygulaması projesinde kullanılacak öğe şablonunu etkinleştirme

Sihirbaz, temel bir şablon oluşturmak için işin büyük bölümünü yapar, ancak çoğu durumda şablonu dışarı aktardıktan sonra .vstemplate dosyasını el ile değiştirmeniz gerekir. Örneğin, öğenin Evrensel Windows Uygulaması projesi için Yeni Öğe Ekle iletişim kutusunda görünmesini istiyorsanız, birkaç ek adım gerçekleştirmeniz gerekir.

  1. Bir öğe şablonunu dışarı aktarmak için önceki bölümdeki adımları izleyin.

  2. Oluşturulan .zip dosyasını ayıklayın ve .vstemplate dosyasını Visual Studio'da açın.

  3. C# Evrensel Windows projesi için öğesinin içine aşağıdaki XML'yi <TemplateData> ekleyin:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>

  4. Visual Studio'da .vstemplate dosyasını kaydedin ve kapatın.

  5. .vstemplate dosyasını kopyalayıp .zip dosyasına geri yapıştırın.

    Dosya Kopyala iletişim kutusu görüntülenirse Kopyala ve Değiştir seçeneğini belirleyin.

Artık Yeni Öğe Ekle iletişim kutusundan Evrensel Windows projesine bu şablonu temel alan bir öğe ekleyebilirsiniz.

Belirli proje alt türleri için şablonları etkinleştirme

Şablonunuzun yalnızca Windows, Office, Veritabanı veya Web gibi belirli proje alt türleri için gösterilmesini belirtebilirsiniz.

  1. Öğe şablonunun ProjectType.vstemplate dosyasında öğesini bulun.

  2. öğesinin hemen arkasına ProjectType bir ProjectSubType öğesi ekleyin.

  3. öğesinin metin değerini aşağıdaki değerlerden birine ayarlayın:

    • Windows
    • Office
    • Veritabanı
    • Web

Örneğin: <ProjectSubType>Database</ProjectSubType>.

Aşağıdaki örnekte, Office projeleri için bir öğe şablonu gösterilmektedir.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

El ile öğe şablonu oluşturma

Bazı durumlarda, sıfırdan el ile bir öğe şablonu oluşturmak isteyebilirsiniz.

  1. Proje ve proje öğesi oluşturma.

  2. Proje öğesini şablon olarak kaydedilmeye hazır olana kadar değiştirin.

  3. Parametre değiştirme işleminin nerede gerçekleşeceği (herhangi bir yerde) belirtmek için kod dosyasını değiştirin. Parametre değiştirme hakkında daha fazla bilgi için bkz . Nasıl yapılır: Şablonda parametreleri değiştirme.

  4. Bir XML dosyası oluşturun ve proje öğesi dosyanızla aynı dizinde bir .vstemplate dosya uzantısıyla kaydedin.

  5. Öğe şablonu meta verilerini sağlamak için .vstemplate XML dosyasını düzenleyin. Daha fazla bilgi için bkz . Şablon şeması başvurusu (genişletilebilirlik) ve önceki bölümdeki örnek.

  6. .vstemplate dosyasını kaydedin ve kapatın.

  7. Windows Gezgini'nde, şablonunuza eklemek istediğiniz dosyaları seçin. Seçime sağ tıklayın ve Sıkıştırılmış (sıkıştırılmış) klasöre> Gönder'i seçin. Seçtiğiniz dosyalar bir .zip dosyasında sıkıştırılır.

  8. .zip dosyasını kopyalayın ve kullanıcı öğesi şablonu konumuna yapıştırın. Varsayılan dizin: %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Daha fazla bilgi için bkz . Nasıl yapılır: Proje ve öğe şablonlarını bulma ve düzenleme.

İlgili içerik