共用方式為

ProjectItem 項目 (Visual Studio 項目範本)

  • 發行項

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

注意

元素 ProjectItem 會接受不同的屬性，視範本是針對專案或專案而定。 本主題說明 ProjectItem 項目的 元素。 如需專案範本專案ProjectItem的說明，請參閱 ProjectItem 元素（Visual Studio 項目範本）。

<VSTemplate><TemplateContent><ProjectItem>

語法

<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.vb 檔案存在於範本 .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>

另請參閱