Proje şablonlarına etiket ekleme

Makale
01/13/2024

Visual Studio 2019 sürüm 16.1 Preview 2'den başlayarak, proje şablonlarınıza dil, platform ve proje türü etiketleri ekleyebilirsiniz.

Etiketler, Yeni Proje iletişim kutusunda iki yerde kullanılır:

Etiketler şablon açıklamasının altında görünür.
Etiketler, şablonun aranmasını ve filtrelenebilmesini sağlar.

.vstemplate XML dosyasını güncelleştirerek etiketler ekleyebilirsiniz. Visual Studio'da yerleşik olarak yer alan şablon etiketlerini kullanabilir veya özel şablon etiketleri oluşturabilirsiniz. Şablon etiketleri yalnızca Visual Studio 2019 Yeni Proje iletişim kutusunda görünür. Şablon etiketleri, şablonun Visual Studio'nun önceki sürümlerinde nasıl işleyeceğini etkilemez.

Etiket ekleme veya düzenleme

Aşağıdaki eylemlerden birini gerçekleştirirken proje şablonunuzun .vstemplate XML dosyasına etiket eklemek veya düzenlemek isteyebilirsiniz:

Şablonu Dışarı Aktar sihirbazını kullanarak yeni bir proje şablonu oluşturun.
Mevcut proje şablonunuzu güncelleştirin.
Yeni bir VSIX proje şablonu oluşturun.

Sözdizimi

<LanguageTag> Language Name </LanguageTag>
<PlatformTag> Platform Name </PlatformTag>
<ProjectTypeTag> Project Type </ProjectTypeTag>

Özellikler

Gelişmiş kullanıcı senaryolarında aşağıdaki isteğe bağlı öznitelikleri kullanabilirsiniz:

Öznitelik	Açıklama
`Package`	Visual Studio paket kimliğini belirten GUID.
`ID`	Visual Studio kaynak kimliğini belirtir.

Söz dizimi:

<LanguageTag Package="{PackageID}" ID="ResourceID" />
<PlatformTag Package="{PackageID}" ID="ResourceID" />
<ProjectTypeTag Package="{PackageID}" ID="ResourceID" />

Öğeler

Alt öğeleri

Yok.

Üst öğeler

Öğe	Açıklama
TemplateData	(Gerekli) Şablonu kategorilere ayırır ve Yeni Proje iletişim kutusunda veya Yeni Öğe Ekle iletişim kutusunda nasıl görüntüleneceğini tanımlar.

Metin değeri

ve ID özniteliklerini kullanmadığınız Package sürece bir metin değeri gereklidir.

Metin, şablonun adını sağlar.

Yerleşik etiketler

Visual Studio yerleşik etiketlerin listesini sunar. Yerleşik bir etiket eklediğinizde, etiket yerelleştirilmiş bir kaynağı işler.

Aşağıdaki listede Visual Studio'da kullanılabilen yerleşik etiketler gösterilmektedir. Karşılık gelen değerler parantez içinde gösterilir.

Dil etiketi	Platform etiketi	Proje türü etiketi
C++ (`cpp`)	Android (`android`)	Bulut (`cloud`)
C# (`csharp`)	Azure (`azure`)	Konsol (`console`)
F# (`fsharp`)	iOS (`ios`)	Masaüstü (`desktop`)
Java (`java`)	Linux (`linux`)	Uzantılar (`extension`)
JavaScript (`javascript`)	macOS (`macos`)	Oyunlar (`games`)
Python (`python`)	tvOS (`tvos`)	IoT (`iot`)
Sorgu Dili (`querylanguage`)	Windows (`windows`)	Kitaplık (`library`)
TypeScript (`typescript`)	Windows Uygulama SDK'sı (`windowsappsdk`)	Machine Learning (`machinelearning`)
Visual Basic (`visualbasic`)	Xbox (`xbox`)	Mobil (`mobile`)
XAML (`xaml`)		Office (`office`)
		Diğer (`other`)
		Hizmet (`service`)
		Test (`test`)
		UWP (`uwp`)
		Web (`web`)
		WinUI (`winui`)

Örnek

Aşağıdaki örnekte, Visual C# uygulaması için proje şablonunun meta verileri gösterilmektedir:

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>csharp</ProjectType>
        <LanguageTag>csharp</LanguageTag>
        <PlatformTag>windows</PlatformTag>
        <PlatformTag>linux</PlatformTag>
        <PlatformTag>My Platform</PlatformTag>
        <ProjectTypeTag>console</ProjectTypeTag>
        <ProjectTypeTag>desktop</ProjectTypeTag>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

Share via