共用方式為


建立項目範本

本文說明如何使用 [ 匯出範本精靈 ] 或手動建立專案範本,以及如何編輯和使用專案範本。 如果您的範本包含多個檔案,另請參閱 如何:建立多檔案項目範本

新增項目範本

  1. 在 Visual Studio 中建立或開啟專案。

  2. 選取 [專案>新增專案] 或按 Ctrl+Shift+A

  3. 在 [ 新增專案 ] 對話框中,選取專案,然後選取 [ 新增 ] 將其新增至專案。

  4. 視需要修改項目,並指出項目中的位置,如果有需要的話,應該進行參數替換。 如需詳細資訊,請參閱 如何:取代範本中的參數

  5. 儲存專案。

  6. 選取 [項目>匯出範本]。 [ 匯出範本精靈 ] 隨即開啟。

  7. 在 [ 選擇範本類型 ] 頁面上,選擇 [ 項目範本],選取包含該專案的專案,然後選取 [ 下一步]。

  8. 在 [ 選取要導出的專案 ] 頁面上,選擇您要為其建立範本的項目,然後選取 [ 下一步]。

  9. 在 [ 選取項目參考 ] 頁面上,選取要包含在範本中的任何元件參考,然後選取 [ 下一步]。

  10. 在 [ 選取範本選項] 頁面上:

    • 輸入範本名稱和選擇性描述、圖示影像和預覽影像。

      項目的圖示檔案 .ico 檔案,如 Visual Studio 的影像和圖示中所述。 預覽影像是出現在 [ 新增專案 ] 對話框中的 200 x 200 影像。 您可以下載 Visual Studio 映像庫 ,以取得與 Visual Studio 樣式一致的圖示。

    • 選取是否要 自動將範本匯入 Visual Studio ,並在 輸出檔案資料夾中顯示總管視窗

  11. 選取 完成

範本檔案會壓縮成 .zip 檔案,並複製到精靈中 [ 輸出位置] 底下的目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <版本>\My Exported Templates

如果您選取 [ 自動將範本匯入 Visual Studio], .zip 檔案也會新增至使用者 ItemTemplates 目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates

您現在可以在專案中使用項目範本。

使用項目範本

  1. 如果您在建立範本時未選取 [自動將範本匯入 Visual Studio ],請將 .zip 檔案複製到 您的 ItemTemplates 目錄。 默認位置 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates
  2. 關閉 Visual Studio,然後重新開啟它。
  3. 建立新的專案,或開啟現有的專案,然後選取 [ 專案>新增專案]
  4. 從 [ 新增專案 ] 對話框中選取項目範本。 如果您在 [ 匯出範本精靈] 中新增描述,描述會出現在對話框右側。
  5. 選取 [新增 ] 將範本專案新增至您的專案。

編輯 .vstemplate 檔案

精靈會建立基本範本,但在某些情況下,您需要在匯出範本之後手動修改 .vstemplate 檔案。 例如,如果您想要讓項目出現在通用 Windows App 專案的 [ 新增專案 ] 對話框中,您必須編輯 .vstemplate 檔案。

  1. 擷取導出的專案範本 .zip 檔案,然後在Visual Studio中開啟 .vstemplate 檔案。
  2. 視需要編輯檔案。 若為 C# 通用 Windows 專案,請在 <TemplateID>Microsoft.CSharp.Class</TemplateID> 元素中新增 <TemplateData>
  3. 儲存並關閉 .vstemplate 檔案,並在 .zip 檔案中取代它。

啟用特定項目子類型的範本

您可以編輯 .vstemplate 檔案,以指定您的專案範本只針對某些專案子類型顯示,例如 Windows、Office、Database 或 Web。

  1. 開啟 .vstemplate 檔案以進行編輯。
  2. 元素後面立即新增一個ProjectType 元素,其值為 WindowsOfficeDatabaseWeb。 例如: <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>

手動建立項目範本

您可以從頭手動建立項目範本,而不是使用精靈。

  1. 建立專案並新增專案。
  2. 視需要修改專案,例如新增應執行任何參數取代的位置,並儲存專案。
  3. 建立 XML 檔案,並以 .vstemplate 擴展名儲存在與項目項目檔相同的目錄中。
  4. 將專案範本元數據新增至 .vstemplate XML 檔案,如上述範例所示。 如需詳細資訊,請參閱範本架構參考(擴充性)。
  5. 儲存並關閉 .vstemplate 檔案。
  6. 在 Windows 檔案總管中,選取您想要包含在範本中的檔案,包括 .vstemplate 檔案。 以滑鼠右鍵按下選取範圍,然後選取 [ 壓縮至>ZIP 檔案]。
  7. 複製產生的 .zip 檔案,並將其貼到 Visual Studio 用戶專案範本位置。 默認目錄 %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates