HOW TO：發行專案範本

更新：2007 年 11 月

若要讓範本顯示在 [新增專案] 對話方塊中，就必須安裝在電腦上的正確位置。如果要簡化這個程序，您可以將範本 .zip 檔案放置在 Visual Studio 安裝程式 (.vsi) 檔中，然後讓 Visual Studio 內容安裝程式，將檔案置於正確位置。使用 .vsi 檔案，您也可以和其他開發人員共用範本 (或 Visual Studio 的其他元件)。

.VSI 檔案

.vsi 檔案是一個 .zip 檔，且副檔名經過重新命名。.Vsi 檔案包含下列內容：

• 描述內容的 .xml 檔案。這個檔案的副檔名必須是 .vscontent，且必須遵守特定的 XML 結構描述。如需 .vscontent XML 結構描述的完整定義，請參閱 HOW TO：封裝社群元件以使用 Visual Studio 內容安裝程式。

• 內容檔案，例如範本 .zip 檔案。如需建立範本 .zip 檔案的詳細資訊，請參閱建立專案範本和項目範本。

如需如何安裝 .vsi 檔案的詳細資訊，請參閱 HOW TO：安裝社群元件。

您必須在範本的 .vscontent 檔案中設定特定的值和屬性，Visual Studio 內容安裝程式才會知道如何安裝以及安裝位置。在範本 .vscontent 檔案中，您必須執行下列步驟：

• 將 FileContentType 項目的值設定為 VSTemplate。

• 新增具有下列屬性的 Attribute 項目：

  • ProjectType 屬性：指定專案類型為 Visual Basic、Visual C# 或 Visual Web Developer。

  • ProjectSubType 屬性：指定要在 [新增專案] 對話方塊中顯示範本的子類別。

  • TemplateType 屬性：指定範本的類型為 Project 或 Item。

若要建立範本 .vsi 檔案

1. 為內容建立有效的 .vscontent 檔案。如需 .vscontent 檔案結構描述的詳細資訊，請參閱 HOW TO：封裝社群元件以使用 Visual Studio 內容安裝程式。

2. 選取 .vscontent 檔案以及要包括在 .vsi 檔中的其他檔案。在選取的檔案上按一下滑鼠右鍵，再按一下 [傳送到] 和 [壓縮的資料夾]。選取的檔案會壓縮成一個 .zip 檔中。

3. 將 .zip 檔案的副檔名重新命名為 .vsi。

   注意事項：
   如果要在 Visual Studio 內容安裝程式中顯示您專案範本的發行者資訊，就必須簽署 .vsi 檔。如需詳細資訊，請洽詢數位憑證廠商。

範例

下列範例會顯示內含專案範本的 .vsi 檔的 .vscontent 檔案。下列檔案應該包含在此內容的 .vsi 檔案中：

• .vscontent 檔案，內含本範例中的程式碼。

• 專案範本，MyProjectTemplate.zip。

在此範例中，範本會安裝在 [新增專案] 對話方塊的 [Visual Basic] 根類別中。如果要將範本安裝在 [Visual Basic] 子類別中，請將子類別名稱指定為 ProjectSubType 屬性的值。

注意事項：
下列範例使用 ContentVersion 項目值 2.0。如果 Visual Studio 2005 或 Visual Studio 2008 可以使用專案範本，請使用值 1.0。如果專案範本是 Visual Studio 2008 特定的，請使用 2.0。

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyProjectTemplate.zip</FileName>
        <DisplayName>Sample Project Template</DisplayName>
        <Description>A project template created for this example.</Description>
        <FileContentType>VSTemplate</FileContentType>
        <ContentVersion>2.0</ContentVersion>
        <Attributes>
            <Attribute name="ProjectType" value="Visual Basic"/>
            <Attribute name="ProjectSubType" value=""/>
            <Attribute name="TemplateType" value="Project"/>
        </Attributes>
    </Content>
</VSContent>

請參閱

工作

HOW TO：封裝社群元件以使用 Visual Studio 內容安裝程式

其他資源

進階範本程序