ProjectItem öğesi (Visual Studio öğe şablonları)

  • Makale

Öğe şablonuna dahil edilen bir dosyayı belirtir.

Not

öğesi, şablonun ProjectItem bir proje için mi yoksa bir öğe için mi olduğuna bağlı olarak farklı öznitelikleri kabul eder. Bu konuda öğenin öğesi açıklanmaktadır ProjectItem . Proje şablonları için öğesinin ProjectItem açıklaması için bkz . ProjectItem öğesi (Visual Studio proje şablonları).

<VSTemplate><TemplateContent><ProjectItem>

Sözdizimi

<ProjectItem
    SubType="Form/Component/CustomControl/UserControl"
    CustomTool="string"
    ItemType="string"
    ReplaceParameters="true/false"
    TargetFileName="TargetFileName.ext">
        FileName.ext
</ProjectItem>

Öznitelikler ve öğeler

Aşağıdaki bölümlerde öznitelik, alt öğeler ve üst öğeler açıklanmaktadır.

Özellikler

Öznitelik Açıklama
SubType İsteğe bağlı öznitelik.

Çok dosyalı öğe şablonundaki bir öğenin alt türünü belirtir. Bu değer, Visual Studio'nın öğeyi açmak için kullanacağı düzenleyiciyi belirlemek için kullanılır.
CustomTool İsteğe bağlı öznitelik.

Proje dosyasındaki öğenin CustomTool'unu ayarlar.
ItemType İsteğe bağlı öznitelik.

Proje dosyasındaki öğenin ItemType'ını ayarlar.
ReplaceParameters İsteğe bağlı öznitelik.

Öğenin şablondan proje oluşturulduğunda değiştirilmesi gereken parametre değerlerine sahip olup olmadığını belirten boole değeri. Varsayılan değer false olarak belirlenmiştir.
TargetFileName İsteğe bağlı öznitelik.

Şablondan oluşturulan öğenin adını belirtir. Bu öznitelik, bir öğe adı oluşturmak için parametre değiştirme kullanmak için kullanışlıdır.

Alt öğeleri

Yok.

Üst öğeler

Öğe Açıklama
Templatecontent Şablonun içeriğini belirtir.

Metin değeri

Bir metin değeri gereklidir.

string Şablon .zip dosyasındaki bir dosyanın adını temsil eden bir.

Açıklamalar

ProjectItem isteğe bağlı bir alt öğesidir TemplateContent.

TargetFileName özniteliği, dosyaları parametrelerle yeniden adlandırmak için kullanılabilir. Örneğin, MyFile.vb dosyası şablonun .zip dosyasının kök dizininde varsa, ancak dosyanın Yeni Öğe Ekle iletişim kutusunda kullanıcı tarafından sağlanan dosya adına göre adlandırılmasını istiyorsanız, aşağıdaki XML'yi kullanabilirsiniz:

<ProjectItem TargetFileName="$fileinputname$.vb">MyFile.vb</ProjectItem>

Bu şablondan bir öğe oluşturulduğunda, dosya adı kullanıcının Yeni Öğe Ekle iletişim kutusuna girdiği adı temel alır. Bu, çok dosyalı öğe şablonları oluştururken kullanışlıdır. Daha fazla bilgi için bkz . Nasıl yapılır: Çok dosyalı öğe şablonları ve Şablon parametreleri oluşturma.

Örnek

Aşağıdaki örnekte Visual C# sınıfı için standart öğe şablonunun meta verileri gösterilmektedir.

<VSTemplate Type="Item" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <DefaultName>MyClass.cs</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem ReplaceParameters="true">MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>

Ayrıca bkz.