HOW TO:發行程式碼片段
更新:2007 年 11 月
如果要讓程式碼片段顯示在使用者電腦的程式碼編輯器上,就必須將程式碼片段安裝在電腦上,並使用 [程式碼片段管理員] 匯入 Visual Studio。如果要簡化這個處理步驟,請將片段檔案放在 Visual Studio 安裝程式 (.vsi) 檔案中,使用 Visual Studio 內容安裝程式即可將檔案放在正確的位置。這樣,就可以輕鬆地與整個社群的其他開發人員共用 .vsi 檔案。
.VSI 檔案
.Vsi 檔案是用來交換開發人員社群中的 Visual Studio 內容。.vsi 檔是個 .zip 檔,但是必須重新命名為 .vsi 副檔名,這樣 Visual Studio 內容安裝程式就知道要如何處理檔案。.Vsi 檔案內含下列內容:
.vscontent 檔內含的 XML 會描述 .vsi 檔案的內容並遵循特定 XML 結構描述。如需 .vscontent 檔案的結構描述完整定義,請參閱 HOW TO:封裝社群元件以使用 Visual Studio 內容安裝程式。
內容檔案,例如 .snippet 檔案。如需如何建立 .snippet 檔案的詳細資訊,請參閱 HOW TO:建立基本的程式碼片段。
Visual Studio 內容安裝程式會使用 .vsi 檔案,將共用內容安裝至正確的位置。如需如何安裝 .vsi 檔案的詳細資訊,請參閱 HOW TO:安裝社群元件。
您必須在 .vscontent 檔案中設定特定的值和屬性,讓 Visual Studio 內容安裝程式得知安裝內容檔案的方式和位置。例如,在程式碼片段的 .vscontent 檔案中,您必須執行下列步驟:
將 FileContentType 項目的值設定為 Code Snippet。
新增具有下列屬性的 Attribute 項目:
- lang:指定程式碼片段的語言,包括 csharp、jsharp、vb 或 xml。
若要建立程式碼片段 .vsi 檔案
為內容建立有效的 .vscontent 檔案。如需 .vscontent 檔案結構描述的詳細資訊,請參閱 HOW TO:封裝社群元件以使用 Visual Studio 內容安裝程式。
選取要包含在 .vsi (包括 .vscontent) 檔中的檔案,在項目上按一下滑鼠右鍵然後按一下 [傳送到] 和 [壓縮的 (zipped) 資料夾]。選取的檔案會壓縮至單一的 .zip 檔案中。
將 .zip 檔案的副檔名重新命名為 .vsi。
注意事項: 若要顯示 Visual Studio 內容安裝程式中程式碼片段的發行者資訊,您必須簽署 .vsi 檔案。如需詳細資訊,請洽詢數位憑證廠商。
範例
下列範例會顯示包含程式碼片段的 .vsi 檔案中的 .vscontent 檔案。這個範例使用 ContentVersion 值 2.0。如果 Visual Studio 或 Visual Studio 2008 可以使用程式碼片段,請使用值 1.0。如果程式碼片段是 Visual Studio 2008 所專用,請使用 2.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 內容安裝程式