Comment : publier des modèles de projet

Article
08/21/2008

Mise à jour : novembre 2007

Pour qu'un modèle apparaisse dans la boîte de dialogue Nouveau projet, il doit être installé à l'emplacement approprié sur l'ordinateur. Pour simplifier ce processus, placez votre fichier de modèle .zip dans un fichier du Programme d'installation de Visual Studio (.vsi) et utilisez le Programme d'installation de contenu de Visual Studio pour enregistrer le modèle à l'emplacement approprié. En utilisant un fichier .vsi, vous pouvez également partager votre modèle (ou d'autres composants pour Visual Studio) avec d'autres développeurs.

Fichiers .VSI

Un fichier .vsi est un fichier .zip dont l'extension de nom de fichier est renommée. .Les fichiers .vsi contiennent les éléments suivants :

Un fichier .xml qui décrit le contenu. Ce fichier doit avoir l'extension de nom de fichier .vscontent et doit suivre un schéma XML spécifique. Pour une définition complète du schéma XML .vscontent, consultez Comment : empaqueter des composants de communauté pour utiliser le programme d'installation de contenu Visual Studio.
Les fichiers de contenu ; par exemple, un fichier de modèle compressé (.zip). Pour plus d'informations sur la création de fichiers de modèles .zip, consultez Création de modèles de projet et d'élément.

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 pour votre modèle afin que le Programme d'installation de contenu de Visual Studio puisse déterminer comment et où l'installer. Dans le fichier .vscontent d'un modèle, vous devez effectuer les opérations suivantes :

Affectez à l'élément FileContentType la valeur VSTemplate.
Ajoutez un élément Attribute disposant des attributs suivants :
- Attribut ProjectType : spécifie le type de projet, Visual Basic, Visual C# ou Visual Web Developer.
- Attribut ProjectSubType : spécifie la sous-catégorie dans laquelle afficher le modèle dans la boîte de dialogue Nouveau projet.
- Attribut TemplateType : spécifie le type de modèle, Project ou Item.

Pour créer un fichier de modèle .vsi

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.
Sélectionnez le fichier .vscontent et les autres fichiers que vous souhaitez inclure dans le fichier .vsi. Cliquez avec le bouton droit sur la sélection, cliquez sur Envoyer vers, puis sur Dossier compressé. Les fichiers sélectionnés sont compressés dans un seul fichier .zip.

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

Remarque :
Pour afficher des informations de l'éditeur sur votre modèle de projet dans le Programme d'installation de contenu Visual Studio, vous devez signer le fichier .vsi. Pour plus d'informations, contactez un fournisseur de certificats numériques.

Exemple

L'exemple suivant montre le fichier .vscontent destiné à un fichier .vsi qui contient un modèle de projet. Les fichiers suivants seraient inclus dans le fichier .vsi pour ce contenu :

Un fichier .vscontent qui contient le code issu de cet exemple.
Un modèle de projet, MyProjectTemplate.zip.

Dans cet exemple, le modèle est installé dans la catégorie racine Visual Basic de la boîte de dialogue Nouveau projet. Si vous souhaitez installer le modèle dans une sous-catégorie Visual Basic, spécifiez le nom de sous-catégorie en tant que valeur de l'attribut ProjectSubType.

Remarque :
L'exemple suivant utilise une valeur d'élément ContentVersion de 2.0. Si un modèle de projet peut être utilisé par Visual Studio 2005 ou Visual Studio 2008, utilisez la valeur 1.0. Si un modèle de projet est spécifique à Visual Studio 2008, utilisez 2.0.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyProjectTemplate.zip</FileName>
        <DisplayName>Sample Project Template</DisplayName>
        <Description>A project template created for this example.</Description>
        <FileContentType>VSTemplate</FileContentType>
        <ContentVersion>2.0</ContentVersion>
        <Attributes>
            <Attribute name="ProjectType" value="Visual Basic"/>
            <Attribute name="ProjectSubType" value=""/>
            <Attribute name="TemplateType" value="Project"/>
        </Attributes>
    </Content>
</VSContent>

Voir aussi

Tâches

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

Autres ressources

Procédures de modèle avancées

Share via