Procedura: pubblicare frammenti di codice

Articolo
09/12/2008

Aggiornamento: novembre 2007

Affinché un frammento di codice venga visualizzato nell'editor di codice sul computer dell’utente, deve essere installato sul computer e deve essere importato in Visual Studio utilizzando Gestione frammenti di codice. Per semplificare questa procedura è possibile inserire il file del frammento di codice in un file Visual Studio Installer (.vsi) e utilizzare Visual Studio Content Installer per collocarlo nella posizione corretta. Il file vsi potrà quindi essere facilmente condiviso con altri sviluppatori all'interno della comunità.

File VSI

.I file vsi vengono utilizzati per lo scambio di contenuti Visual Studio nella comunità di sviluppatori. Un file .vsi è semplicemente un file .zip, ma è necessario rinominarlo utilizzando un'estensione .vsi in modo tale che Visual Studio Content Installer sappia come gestirlo. .I file vsi contengono gli elementi seguenti:

Un file .vscontent che contiene codice XML che descrive il contenuto del file .vsi e segue un schema XML specifico. Per una definizione completa dello schema dei file .vscontent, vedere Procedura: creare package dei componenti della comunità per utilizzare Visual Studio Content Installer.
File di dati, ad esempio un file .snippet. Per ulteriori informazioni su come identificare file .snippet, vedere Procedura: creare un frammento di codice di base.

In Visual Studio Content Installer vengono utilizzati i file vsi per installare contenuti condivisi nella posizione corretta. Per ulteriori informazioni sulle modalità di installazione dei file .vsi, vedere Procedura: installare componenti altrui.

È necessario impostare valori e attributi specifici nel file .vscontent, in modo che siano disponibili in Visual Studio Content Installer le informazioni relative alle modalità e alle posizioni in cui installare i file di dati. Ad esempio, nel file .vscontent per un frammento di codice, è necessario eseguire le operazioni seguenti:

Impostare il valore dell'elemento FileContentType su Code Snippet.
Aggiungere un elemento Attribute con l’attributo seguente:
- lang: specifica il linguaggio del frammento di codice, csharp, jsharp, vb o xml.

Per creare il file vsi del frammernto di codice

Creare un file vscontent valido per il contenuto. Per ulteriori informazioni sullo schema dei file .vscontent, vedere Procedura: creare package dei componenti della comunità per utilizzare Visual Studio Content Installer.
Selezionare i file che si desidera includere nel file .vsi (incluso il file .vscontent), fare clic con il pulsante destro del mouse sul file selezionato, fare clic su Invia a e quindi fare clic su Cartella compressa. I file selezionati verranno compressi in un unico file zip.

Rinominare l'estensione del file .zip in .vsi.

Nota:
Per visualizzare le informazioni sull'editore per il frammento di codice in Visual Studio Content Installer, è necessario firmare il file vsi. Per ulteriori informazioni, contattare un fornitore di certificati digitali.

Esempio

Nell'esempio riportato di seguito compare un file .vscontent per un file .vsi che contiene un frammento di codice. L’esempio utilizza un valore di ContentVersion pari a 2,0. Se un frammento di codice può essere utilizzato sia da Visual Studio sia da Visual Studio 2008, utilizzare un valore di 1,0. Se un frammento di codice è specifico di Visual Studio 2008, utilizzare 2,0. Nel file .vsi sono inseriti i file seguenti:

File .vscontent con il codice indicato nell'esempio.
Frammento di codice 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>

Vedere anche

Attività

Procedura: creare package dei componenti della comunità per utilizzare Visual Studio Content Installer

Riferimenti

Creazione e utilizzo di frammenti di codice IntelliSense

Condividi tramite