Procedura: pubblicare frammenti di codice

Articolo
08/11/2011

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 community.

File VSI

I file con estensione vsi vengono utilizzati per lo scambio di contenuti di Visual Studio nella community di sviluppatori. Un file vsi è semplicemente un file zip che deve essere rinominato utilizzando un'estensione vsi in modo che Visual Studio Content Installer sia in grado di gestirlo. I file vsi contengono quanto segue:

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 pacchetti dei componenti 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: cercare e installare componenti della community.

È 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, che può essere csharp, vb, SQL, JScript, HTML 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 pacchetti dei componenti 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. Nell'esempio viene utilizzato un valore ContentVersion di 2.0. Se un frammento di codice è specifico di Visual Studio 2008 o versioni successive, utilizzare 2.0. Se può essere utilizzato anche da Visual Studio 2005, utilizzare un valore 1.0. I file seguenti verranno inclusi nel file con estensione vsi:

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 pacchetti dei componenti per utilizzare Visual Studio Content Installer

Riferimenti

Creazione e utilizzo di frammenti di codice IntelliSense

Condividi tramite