Visual Studio şablonu bildirim şeması başvurusu

  • Makale

Bu şema, Visual Studio projesi veya öğe şablonları için oluşturulan Visual Studio şablon bildirimi (.vstman) dosyalarının biçimini açıklar. Şema ayrıca konumu ve şablonla ilgili diğer ilgili bilgileri de açıklar.

: Ayrı öğe ve proje şablonu dizinleri olduğundan, bildirimde hiçbir zaman öğe ve proje şablonlarının karışımı olmamalıdır.

Önemli

Bu bildirim Visual Studio 2017'den itibaren kullanılabilir.

VSTemplateManifest öğesi

Bildirimin kök öğesi.

Özellikler

  • Sürüm: Şablon bildiriminin sürümünü temsil eden bir dize. Gerekli.

  • Yerel ayar: Şablon bildiriminin yerel ayarını veya yerel ayarlarını temsil eden bir dize. Yerel ayar değeri tüm şablonlar için geçerlidir. Her yerel ayar için ayrı bir bildirim kullanmanız gerekir. isteğe bağlı.

Alt öğeleri

  • VSTemplateContainer İsteğe Bağlı.

  • VSTemplateDir İsteğe Bağlı.

Üst öğe

Yok.

VSTemplateContainer

Şablon bildirim öğelerinin kapsayıcısı. Bir bildirim, tanımladığı her şablon için bir şablon kapsayıcısı vardır.

Özellikler

VSTemplateType: Şablonun türünü belirten bir dize değeri ("Project", "Item"veya "ProjectGroup"). Zorunlu

Alt öğeleri

  • RelativePathOnDisk: Disk üzerindeki şablon dosyasının göreli yolu. Bu konum, şablonun Yeni Proje veya Yeni Öğe iletişim kutusunda gösterilen şablon ağacındaki yerleşimini de tanımlar. Dizin olarak dağıtılan şablonlar ve tek tek dosyalar için bu yol, şablon dosyalarını içeren dizine başvurur. .zip dosyası olarak dağıtılan şablonlar için, bu yol .zip dosyasının yolu olmalıdır.

  • **VSTemplateHeader: Üst bilgiyi açıklayan TemplateData öğesi.

Üst öğe

VSTemplateManifest

VSTemplateDir

Şablonun bulunduğu dizini açıklar. Bir bildirim, dizinlerin şablon kategori ağacındaki görünümlerini denetlemesi için yerelleştirilmiş ad ve sıralama düzeni sağlayan birden çok VSTemplateDir girdisi içerebilir.

Tasarımlarından dolayı VSTemplateDir girişleri yalnızca yerel ayar olmayan belirtilen bildirimlerde görünmelidir.

Özellikler

Yok.

Alt öğeleri

  • RelativePath: Şablonun yolu. Yol başına yalnızca bir giriş olabileceğinden, ilki tüm bildirimler için kazanır.

  • LocalizedName: Yerelleştirilmiş adı belirten bir NameDescriptionIcon öğesi. isteğe bağlı.

  • SortOrder: Sıralama düzenini belirten bir dize. isteğe bağlı.

  • ParentFolderOverrideName: Üst klasörün geçersiz kılınan adı. isteğe bağlı. Bu öğe, adı belirten bir dize değeri olan Name özniteliğine sahiptir.

Üst öğe

VSTemplateManifest

NameDescriptionIcon

Büyük olasılıkla yerelleştirilmiş şablonlar için adı ve açıklamayı belirtir. Yukarıdaki LocalizedName bölümüne bakın.

Özellikler

  • Paket: Paketi belirten bir dize değeri. isteğe bağlı.

  • Kimlik: Kimliği belirten bir dize değeri. isteğe bağlı.

Alt öğeleri

Yok.

Üst öğe

Localizedname

Örnekler

Aşağıdaki kod bir proje şablonu .vstman dosyası örneğidir.

<VSTemplateManifest Version="1.0" Locale="1033" xmlns="http://schemas.microsoft.com/developer/vstemplatemanifest/2015">
  <VSTemplateContainer TemplateType="Project">
    <RelativePathOnDisk>CSharp\1033\TestProjectTemplate</RelativePathOnDisk>
    <TemplateFileName>TestProjectTemplate.vstemplate</TemplateFileName>
    <VSTemplateHeader>
      <TemplateData xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
        <Name>TestProjectTemplate</Name>
        <Description>TestProjectTemplate</Description>
        <Icon>TestProjectTemplate.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>
        <SortOrder>1000</SortOrder>
        <TemplateID>aac0aeea-7883-4003-992f-937d53d70ab1</TemplateID>
        <CreateNewFolder>true</CreateNewFolder>
        <DefaultName>TestProjectTemplate</DefaultName>
        <ProvideDefaultName>true</ProvideDefaultName>
      </TemplateData>
    </VSTemplateHeader>
  </VSTemplateContainer>
</VSTemplateManifest>

Aşağıdaki kod bir öğe şablonu .vstman dosyası örneğidir.

<VSTemplateManifest Version="1.0" Locale="1033" xmlns="http://schemas.microsoft.com/developer/vstemplatemanifest/2015">
  <VSTemplateContainer TemplateType="Item">
    <RelativePathOnDisk>CSharp\1033\ItemTemplate1</RelativePathOnDisk>
    <TemplateFileName>ItemTemplate1.vstemplate</TemplateFileName>
    <VSTemplateHeader>
      <TemplateData xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
        <Name>ItemTemplate1</Name>
        <Description>ItemTemplate1</Description>
        <Icon>ItemTemplate1.ico</Icon>
        <TemplateID>bfeadf8e-a251-4109-b605-516b88e38c8d</TemplateID>
        <ProjectType>CSharp</ProjectType>
        <RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>
        <NumberOfParentCategoriesToRollUp>1</NumberOfParentCategoriesToRollUp>
        <DefaultName>Class.cs</DefaultName>
      </TemplateData>
    </VSTemplateHeader>
  </VSTemplateContainer>
</VSTemplateManifest>