ProjectItem 項目 (Visual Studio 項目範本)
更新:2007 年 11 月
指定項目範本中所包含的檔案。
![]() |
---|
ProjectItem 項目會根據範本是專案範本或項目範本而接受不同的屬性 (Attribute)。本主題說明項目的 ProjectItem 項目。如需專案範本之 ProjectItem 項目的說明,請參閱 ProjectItem 項目 (Visual Studio 專案範本)。 |
<ProjectItem
SubType="Form/Component/CustomControl/UserControl"
ReplaceParameters="true/false"
TargetFileName="TargetFileName.ext">
FileName.ext
</ProjectItem>
屬性和項目
下列小節將說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
---|---|
SubType |
選擇性屬性。 指定多檔案項目範本中某一項目的子型別。此值是用以決定 Visual Studio 將用來開啟項目的編輯器。 |
ReplaceParamenters |
選擇性屬性。 布林值,指定項目是否具有當您從範本建立專案時所必須取代的參數值。預設值為 false。 |
TargetFileName |
選擇性屬性。 指定從範本建立之項目的名稱。當您利用參數取代建立項目名稱時,這個屬性將非常有用。 |
子項目
無
父項目
項目 |
描述 |
---|---|
指定範本的內容。 |
文字值
需要文字值。
string,代表範本檔 (.zip) 中之某一檔案的名稱。
備註
ProjectItem 是 TemplateContent 的選擇性子系。
TargetFileName 屬性可以用參數將檔案重新命名。例如,如果範本檔 (.zip) 的根目錄內有一檔案 MyFile.vb,但是您想要根據使用者在 [加入新項目] 對話方塊中所提供的檔名來命名這個檔案,則您將會使用下列 XML:
<ProjectItem TargetFileName="$fileinputname$.vb">MyFile.vb</ProjectItem>
如果項目是從這個範本建立時,檔名將會依據 [加入新項目] 對話方塊中使用者所輸入的名稱。當您建立多檔案項目範本時,這將會非常有用。如需詳細資訊,請參閱 HOW TO:建立多檔案項目範本和樣板參數。
範例
下列範例說明 Visual C# 類別之標準項目範本的中繼資料。
<VSTemplate Type="Item" Version="2.0.0"
xmlns="https://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>