本文說明如何使用 [ 匯出範本精靈 ] 或手動建立專案範本,以及如何編輯和使用專案範本。 如果您的範本包含多個檔案,另請參閱 如何:建立多檔案項目範本。
新增項目範本
在 Visual Studio 中建立或開啟專案。
選取 [專案>新增專案] 或按 Ctrl+Shift+A。
在 [ 新增專案 ] 對話框中,選取專案,然後選取 [ 新增 ] 將其新增至專案。
視需要修改項目,並指出項目中的位置,如果有需要的話,應該進行參數替換。 如需詳細資訊,請參閱 如何:取代範本中的參數。
儲存專案。
選取 [項目>匯出範本]。 [ 匯出範本精靈 ] 隨即開啟。
在 [ 選擇範本類型 ] 頁面上,選擇 [ 項目範本],選取包含該專案的專案,然後選取 [ 下一步]。
在 [ 選取要導出的專案 ] 頁面上,選擇您要為其建立範本的項目,然後選取 [ 下一步]。
在 [ 選取項目參考 ] 頁面上,選取要包含在範本中的任何元件參考,然後選取 [ 下一步]。
在 [ 選取範本選項] 頁面上:
輸入範本名稱和選擇性描述、圖示影像和預覽影像。
項目的圖示檔案 .ico 檔案,如 Visual Studio 的影像和圖示中所述。 預覽影像是出現在 [ 新增專案 ] 對話框中的 200 x 200 影像。 您可以下載 Visual Studio 映像庫 ,以取得與 Visual Studio 樣式一致的圖示。
選取是否要 自動將範本匯入 Visual Studio ,並在 輸出檔案資料夾中顯示總管視窗。
選取 完成。
範本檔案會壓縮成 .zip 檔案,並複製到精靈中 [ 輸出位置] 底下的目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <版本>\My Exported Templates。
如果您選取 [ 自動將範本匯入 Visual Studio], .zip 檔案也會新增至使用者 ItemTemplates 目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates。
您現在可以在專案中使用項目範本。
使用項目範本
- 如果您在建立範本時未選取 [自動將範本匯入 Visual Studio ],請將 .zip 檔案複製到 您的 ItemTemplates 目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates。
- 關閉 Visual Studio,然後重新開啟它。
- 建立新的專案,或開啟現有的專案,然後選取 [ 專案>新增專案]
- 從 [ 新增專案 ] 對話框中選取項目範本。 如果您在 [ 匯出範本精靈] 中新增描述,描述會出現在對話框右側。
- 選取 [新增 ] 將範本專案新增至您的專案。
編輯 .vstemplate 檔案
精靈會建立基本範本,但在某些情況下,您需要在匯出範本之後手動修改 .vstemplate 檔案。 例如,如果您想要讓項目出現在通用 Windows App 專案的 [ 新增專案 ] 對話框中,您必須編輯 .vstemplate 檔案。
- 擷取導出的專案範本 .zip 檔案,然後在Visual Studio中開啟 .vstemplate 檔案。
- 視需要編輯檔案。 若為 C# 通用 Windows 專案,請在
<TemplateID>Microsoft.CSharp.Class</TemplateID>元素中新增<TemplateData>。 - 儲存並關閉 .vstemplate 檔案,並在 .zip 檔案中取代它。
啟用特定項目子類型的範本
您可以編輯 .vstemplate 檔案,以指定您的專案範本只針對某些專案子類型顯示,例如 Windows、Office、Database 或 Web。
- 開啟 .vstemplate 檔案以進行編輯。
- 在 元素後面立即新增一個
ProjectType元素,其值為Windows、Office、Database或Web。 例如:<ProjectSubType>Database</ProjectSubType>。
下列範例顯示用於專案的 .vstemplate 檔案Office。
<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
<TemplateData>
<Name>Class</Name>
<Description>An empty class file</Description>
<Icon>Class.ico</Icon>
<ProjectType>CSharp</ProjectType>
<ProjectSubType>Office</ProjectSubType>
<DefaultName>Class.cs</DefaultName>
</TemplateData>
<TemplateContent>
<ProjectItem>Class1.cs</ProjectItem>
</TemplateContent>
</VSTemplate>
手動建立項目範本
您可以從頭手動建立項目範本,而不是使用精靈。
- 建立專案並新增專案。
- 視需要修改專案,例如新增應執行任何參數取代的位置,並儲存專案。
- 建立 XML 檔案,並以 .vstemplate 擴展名儲存在與項目項目檔相同的目錄中。
- 將專案範本元數據新增至 .vstemplate XML 檔案,如上述範例所示。 如需詳細資訊,請參閱範本架構參考(擴充性)。
- 儲存並關閉 .vstemplate 檔案。
- 在 Windows 檔案總管中,選取您想要包含在範本中的檔案,包括 .vstemplate 檔案。 以滑鼠右鍵按下選取範圍,然後選取 [ 壓縮至>ZIP 檔案]。
- 複製產生的 .zip 檔案,並將其貼到 Visual Studio 用戶專案範本位置。 默認目錄 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates。