建立多檔案項目範本

  • 發行項

項目範本只能指定一個項目，但有時項目是由多個檔案所構成。 例如，Windows Forms 項目範本需要下列三個檔案：

  • 一個包含表單程式碼的檔案

  • 一個包含表單設計工具資訊的檔案

  • 一個包含表單內嵌資源的檔案

多檔案項目範本需要參數，確保建立項目時使用正確的檔案副檔名。 如果您使用 [匯出範本精靈] 建立多檔案項目範本，就會自動產生這些參數，而且不需要進行任何進一步編輯。

使用 [匯出範本精靈]

建立多檔案項目範本使用的方式和建立單一檔案項目範本一樣。 請參閱如何：建立項目範本。 在精靈的 [選取要匯出的項目] 頁面中，選取有相依檔案的檔案 (例如，Windows Forms 表單檔案)。 精靈會自動納入範本的所有相依檔案，例如設計工具和資源檔。

手動建立多檔案項目範本

  1. 以手動建立單一檔案項目範本的方式建立項目範本，但包含構成多檔案項目的每一個檔案。

  2. 在 .vstemplate XML 檔案中，為每個個別的檔案新增 ProjectItem 項目，並在此項目中新增 TargetFileName 屬性。 將 TargetFileName 屬性的值設為 $fileinputname$.FileExtension，其中 FileExtension 是範本中所含檔案的檔案副檔名。 例如：

    <ProjectItem TargetFileName="$fileinputname$.vb">
    Form1.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.Designer.vb">
    Form1.Designer.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.resx">
    Form1.resx
</ProjectItem>

    注意

    將衍生自此範本的項目新增至專案時，檔案名稱會衍生自使用者在 [新增項目] 對話方塊中輸入的名稱。

  3. 選取要包含在範本中的檔案，以滑鼠右鍵按一下選項，選擇 [Send to] (傳送至)>[壓縮的 (zipped) 資料夾]。

    您選取的檔案即會壓縮成 .zip 檔。

  4. 將 .zip 檔案複製到使用者項目範本的位置。 此目錄預設為 %USERPROFILE%\Documents\Visual Studio <版本>\Templates\ItemTemplates。 如需詳細資訊，請參閱如何：尋找並整理範本。

  5. 結束再重新開啟 Visual Studio。

  6. 建立新的專案或開啟現有的專案，然後選擇 [專案]>[新增項目] 或按 Ctrl+Shift+A。

    多檔案項目範本即會出現在 [新增項目] 對話方塊中。

範例

下例示範 Windows Forms 範本。 根據此範本來建立項目時，所建立三個檔案的名稱會符合 [新增項目] 對話方塊中所輸入的名稱。

<VSTemplate Version="2.0.0" Type="Item"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-file Item Template</Name>
        <Icon>Icon.ico</Icon>
        <Description>An example of a multi-file item template</Description>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectItem TargetFileName="$fileinputname$.vb" SubType="Form">
            Form1.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.Designer.vb">
            Form1.Designer.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.resx">
            Form1.resx
        </ProjectItem>
    </TemplateContent>
</VSTemplate>

相關內容