ProjectItem 項目 (Visual Studio 項目範本)

指定包含在專案範本中的檔案。

注意

ProjectItem專案會根據範本是針對專案或專案而接受不同的屬性。 本主題說明 ProjectItem 專案的元素。 如需 ProjectItem 專案範本專案的說明,請參閱專案範本 (Visual Studio 專案範本的 [專案] 元素)

<VSTemplate> <TemplateContent> <ProjectItem>

Syntax

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

屬性和元素

下列章節將說明屬性、子項目和父項目。

屬性

屬性 描述
SubType 選擇性屬性。

指定多檔案專案範本中專案的子類型。 此值可用來判斷 Visual Studio 將用來開啟專案的編輯器。
CustomTool 選擇性屬性。

設定專案檔中專案的 CustomTool。
ItemType 選擇性屬性。

設定專案檔中專案的 ItemType。
ReplaceParameters 選擇性屬性。

布林值,指定專案是否有在從範本建立專案時必須取代的參數值。 預設值為 false
TargetFileName 選擇性屬性。

指定從範本建立之專案的名稱。 這個屬性適用于使用參數取代來建立專案名稱。

子元素

無。

父元素

元素 描述
TemplateContent 指定範本的內容。

文字值

需要文字值。

string,表示範本 .zip 檔中的檔案名。

備註

ProjectItem 是的選擇性子系 TemplateContent

TargetFileName屬性可以用來以參數重新命名檔案。 例如,如果 myfile.txt 檔案的 .zip 根目錄中有檔案,但您想要根據使用者在 [ 加入新專案 ] 對話方塊中提供的檔案名來命名檔案,您可以使用下列 XML:

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

從這個範本建立專案時,檔案名會根據使用者在 [ 加入新專案 ] 對話方塊中輸入的名稱。 這在建立多檔案專案範本時很有用。 如需詳細資訊,請參閱 如何:建立多檔案專案範本範本參數

範例

下列範例說明類別標準專案範本的中繼資料 Visual C# 。

<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>

另請參閱