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

  • Makale

Proje ş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 proje şablonlarının ProjectItem öğesi açıklanmaktadır. Öğe şablonları için ProjectItem öğenin açıklaması için bkz . ProjectItem Öğesi (Visual Studio Öğe Şablonları).

<VSTemplate><TemplateContent><ProjectItem><>

Sözdizimi

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        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
TargetFileName İsteğe bağlı öznitelik.

Şablondan bir proje oluşturulduğunda proje öğesinin adını ve yolunu belirtir. Bu öznitelik, şablon .zip dosyasındaki dizin yapısından farklı bir dizin yapısı oluşturmak veya öğe adı oluşturmak için parametre değiştirme kullanmak için kullanışlıdır.
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.
OpenInEditor İsteğe bağlı öznitelik.

Şablondan bir proje oluşturulduğunda öğenin Visual Studio'daki ilgili düzenleyicisinde açılıp açılmayacağını belirten Boole değeri.

OpenInWebBrowser değeri olan OpenInEditor truebir öğede ve OpenInHelpBrowser öznitelikleri yoksayılır.

Varsayılan değer şudur: false.
OpenInWebBrowser İsteğe bağlı öznitelik.

Şablondan bir proje oluşturulduğunda öğenin Web tarayıcısının açılıp açılmayacağını belirten Boole değeri.

Web tarayıcısında yalnızca projede yerel olan HTML dosyaları ve metin dosyaları açılabilir. Dış URL'ler bu öznitelikle açılamaz.

Varsayılan değer şudur: false.
OpenInHelpBrowser İsteğe bağlı öznitelik.

Şablondan bir proje oluşturulduğunda öğenin Yardım görüntüleyicisinde açılıp açılmayacağını belirten Boole değeri.

Yalnızca projede yerel olan HTML dosyaları ve metin dosyaları Yardım tarayıcısında açılabilir. Dış URL'ler bu öznitelikle açılamaz.

Varsayılan değer şudur: false.
OpenOrder İsteğe bağlı öznitelik.

Öğelerin ilgili düzenleyicilerinde açılma sırasını temsil eden sayısal bir değer belirtir. Tüm değerler 10'un katları olmalıdır. Önce daha yüksek OpenOrder değerlere sahip öğeler açılır.

Alt öğeleri

Yok.

Üst öğeler

Öğe Açıklama
Proje Projeye eklenecek dosyaları veya dizinleri belirtir.

Metin değeri

Bir metin değeri gereklidir.

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

Açıklamalar

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

TargetFileName özniteliği, şablon .zip dosyasındaki dizin yapısından farklı bir dizin yapısı oluşturmak için kullanılabilir. Örneğin, MyFile.vb dosyası şablon .zip dosyasının kökünde varsa ancak dosyanın şablondan oluşturulan tüm projelerde CustomFiles adlı bir dizine yerleştirilmesini istiyorsanız, aşağıdaki XML'yi kullanabilirsiniz:

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

özniteliği, TargetFileName dosya adlarında uluslararası karakterler içeren dosyaları yeniden adlandırmak için de kullanılabilir. Örneğin, bir şablon .zip dosyası Unicode karakterleri içeren dosya adları içeremez, bu nedenle dosyanın bir .zip dosyasına sıkıştırılabilmesi için önce yeniden adlandırılması gerekir. özniteliği, TargetFileName dosya adını özgün Unicode dosya adına geri ayarlamak için kullanılabilir.

özniteliği, TargetFileName dosyaları parametrelerle yeniden adlandırmak için de kullanılabilir. Aşağıdaki yordamda, şablon .zip dosyasının kök dizininde bulunan MyFile.vb dosyasının proje adına göre bir dosya adıyla nasıl yeniden adlandırıldığı açıklanmaktadır.

Dosyaları parametrelerle yeniden adlandırmak için

  1. .vstemplate dosyasında aşağıdaki XML'yi kullanın:

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

  2. Proje dosyasını (Visual Basic projesi için.vbproj ) bir metin düzenleyicisinde veya Visual Studio'da açın.

  3. Proje dosyasında aşağıdaki XML'e benzeyen satırı bulun:

    <Compile Include="MyFile.vb">

  4. Kod satırını aşağıdaki XML ile değiştirin:

    <Compile Include="$safeprojectname$.vb">

    Bu şablondan bir proje oluşturulduğunda, dosya adı kullanıcının Yeni Proje iletişim kutusuna girdiği ada göre oluşturulur ve tüm güvenli olmayan karakterler ve boşluklar kaldırılır. Daha fazla bilgi için bkz . Şablon parametreleri.

Ö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 starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem ReplaceParameters="true">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>

Ayrıca bkz.