Share via

Comment : publier des extraits de code

  • Article

Mise à jour : novembre 2007

Pour afficher un extrait de code dans l'éditeur de code de l'ordinateur d'un utilisateur, installez-le sur l'ordinateur, puis importez-le dans Visual Studio à l'aide du Gestionnaire des extraits de code. Pour simplifier ce processus, vous pouvez placer votre fichier d'extrait dans un fichier du programme d'installation de Visual Studio (.vsi). L'utilisateur peut utiliser le programme d'installation de contenu Visual Studio pour le placer à l'emplacement correct. Le fichier .vsi peut alors être partagé facilement avec d'autres développeurs à l'échelle de la communauté.

Fichiers .VSI

.Les fichiers .vsi permettent d'échanger du contenu Visual Studio au sein de la communauté des développeurs. Un fichier .vsi est un simple fichier .zip, mais il doit être renommé à l'aide d'une extension de nom de fichier vsi pour que le programme d'installation de contenu Visual Studio soit en mesure de le gérer. .Les fichiers .vsi contiennent les éléments suivants :

Le programme d'installation de contenu Visual Studio utilise des fichiers .vsi pour installer le contenu partagé à l'emplacement approprié. Pour plus d'informations sur l'installation de fichiers .vsi, consultez Comment : installer des composants de communauté.

Vous devez définir des valeurs et des attributs spécifiques dans le fichier .vscontent afin que le programme d'installation de contenu Visual Studio puisse déterminer comment et où installer les fichiers de contenu. Par exemple, vous devez effectuer les opérations suivantes dans le fichier .vscontent pour un extrait de code :

  • Attribuez à l'élément FileContentType la valeur Code Snippet.

  • Ajoutez un élément Attribute disposant des attributs suivants :

    • lang : Spécifie le langage de programmation de l'extrait de code : csharp, jsharp, vb ou xml.

Pour créer un fichier .vsi d'extrait de code

  1. Créez un fichier .vscontent valide pour le contenu. Pour plus d'informations sur le schéma de fichier .vscontent, consultez Comment : empaqueter des composants de communauté pour utiliser le programme d'installation de contenu Visual Studio.

  2. Sélectionnez les fichiers à intégrer au fichier .vsi (y compris le fichier .vscontent). Cliquez avec le bouton droit sur la sélection, puis cliquez sur Envoyer vers et Dossier compressé (dossier zippé). Les fichiers sélectionnés sont compressés dans un seul fichier .zip.

  3. Renommez l'extension du fichier .zip en .vsi.

    Remarque :

    Afin d'afficher les informations sur l'éditeur pour votre extrait de code dans le Programme d'installation de contenu Visual Studio, vous devez signer le fichier .vsi. Pour plus d'informations, contactez un fournisseur de certificat numérique.

Exemple

L'exemple suivant présente un fichier .vscontent destiné à un fichier .vsi qui contient un extrait de code. La valeur ContentVersion de cet exemple est 2.0. Si un extrait de code peut être utilisé par Visual Studio ou Visual Studio 2008, utilisez une valeur de 1.0. Si un extrait de code est spécifique à Visual Studio 2008, utilisez 2.0. Les fichiers suivants sont inclus dans ce fichier .vsi :

  • Un fichier .vscontent qui contient le code issu de cet exemple.

  • L'extrait de code 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>

Voir aussi

Tâches

Comment : empaqueter des composants de communauté pour utiliser le programme d'installation de contenu Visual Studio

Référence

Création et utilisation d'extraits de code IntelliSense