共用方式為

HOW TO：發行程式碼片段

  • 發行項

如果要讓程式碼片段顯示在使用者電腦的程式碼編輯器上，就必須將程式碼片段安裝在電腦上，並使用 [程式碼片段管理員] 匯入 Visual Studio。 如果要簡化這個處理步驟，請將片段檔案放在 Visual Studio 安裝程式 (.vsi) 檔案中，使用 Visual Studio 內容安裝程式即可將檔案放在正確的位置。 這樣，就可以輕鬆地與整個社群的其他開發人員共用 .vsi 檔案。

.VSI 檔案

.vsi 檔案是用來交換開發人員社群中的 Visual Studio 內容。 .vsi 檔只是個 .zip 檔，但是必須重新命名為 .vsi 副檔名，這樣 Visual Studio 內容安裝程式就知道要如何處理檔案。.Vsi 檔案內含下列內容：

Visual Studio 內容安裝程式會使用 .vsi 檔案，將共用內容安裝至正確的位置。 如需如何安裝 .vsi 檔案的詳細資訊，請參閱 HOW TO：尋找和安裝社群元件。

您必須在 .vscontent 檔案中設定特定的值和屬性，讓 Visual Studio 內容安裝程式得知安裝內容檔案的方式和位置。 例如，在程式碼片段的 .vscontent 檔案中，您必須執行下列步驟：

  • 將 FileContentType 項目的值設定為 Code Snippet。

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

    • lang：指定程式碼片段的語言，包括 csharp、vb、SQL、JScript、HTML 或 xml。

若要建立程式碼片段 .vsi 檔案

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

  2. 選取要包含在 .vsi (包括 .vscontent) 檔中的檔案，在項目上按一下滑鼠右鍵然後按一下 [傳送到] 和 [壓縮的 (zipped) 資料夾]。 選取的檔案會壓縮至單一的 .zip 檔案中。

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

    注意事項注意事項

    若要顯示 Visual Studio 內容安裝程式中程式碼片段的發行者資訊，您必須簽署 .vsi 檔案。 如需詳細資訊，請洽詢數位憑證廠商。

範例

下列範例會顯示包含程式碼片段的 .vsi 檔案中的 .vscontent 檔案。 此範例使用的 ContentVersion 值為 2.0。 如果程式碼片段為 Visual Studio 2008 (含) 以後版本所專用，則使用 2.0。如果程式碼片段也可為 Visual Studio 2005 所使用，則使用值 1.0。 下列檔案應該包含在這個 .vsi 檔案中：

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

  • 程式碼片段 MyCodeSnippet.snippet。

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyCodeSnippet.snippet</FileName>
        <DisplayName>Sample Code Snippet</DisplayName>
        <Description>A code snippet created for this example</Description>
        <FileContentType>Code Snippet</FileContentType>
        <ContentVersion>2.0</ContentVersion>
        <Attributes>
            <Attribute name="lang" value="vb"/>
        </Attributes>
    </Content>
</VSContent>

請參閱

工作

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

參考

建立和使用 IntelliSense 程式碼片段