Comment : ajouter des références à des modèles

Article
08/10/2011

Utilisez ces procédures pour créer des modèles contenant des références aux assemblys.

Ajout de références dans des modèles de projet

Les modèles de projet incluent toujours un fichier projet qui offre un moyen d'ajouter ou de supprimer des références dans le modèle.

Pour ajouter des références dans des modèles de projet

Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez le modèle que vous souhaitez mettre à jour, entrez le nom et l'emplacement du projet et cliquez sur OK.
Ajoutez ou supprimez des références au projet dans la boîte de dialogue Ajouter une référence. Pour plus d'informations sur l'ajout de références, consultez Comment : ajouter ou supprimer des références dans Visual Studio.
Utilisez l'Assistant Exportation de modèle pour créer un modèle. Pour plus d'informations, consultez Comment : créer des Starter Kits.
Une fois que le modèle mis à jour est compressé dans un fichier .zip, supprimez l'ancien fichier modèle .zip.

Ajout de références à des modèles d'élément

Comme les modèles d'élément ne contiennent pas de fichier projet, la manière d'y ajouter des références diffère de celle que vous utilisez dans le cas de modèles de projet. Vous pouvez ajouter des références à des modèles d'élément par l'Assistant Exporter le modèle ou en modifiant manuellement le fichier .vstemplate dans le modèle.

Notes

Pour que le modèle fonctionne correctement, tous les assemblys référencés doivent être installés sur tous les ordinateurs l'utilisant. Si les assemblys sont absents de certains ordinateurs, mettez-les dans le même emplacement de partage que le modèle, et demandez aux utilisateurs d'installer les assemblys sur leurs ordinateurs. Pour plus d'informations sur l'installation d'assemblys, consultez Comment : installer un assembly dans le Global Assembly Cache.

Pour utiliser l'Assistant Exportation de modèle pour ajouter des références à des modèles d'élément

Ouvrez ou créez un projet dans Visual Studio.
Ajoutez un élément au projet et modifiez-le si nécessaire.
Dans le menu Fichier, cliquez sur Exporter le modèle.
Cliquez sur Modèle d'élément, sélectionnez le projet qui contient l'élément et cliquez sur Suivant.
Sélectionnez l'élément pour lequel créer un modèle et cliquez sur Suivant.
Sélectionnez les références d'assembly à inclure dans le modèle et cliquez sur Suivant.

Notes

La liste d'assemblys est générée à partir des références d'assembly du projet actuel. Si l'assembly que vous souhaitez référencer n'apparaît pas dans la liste, quittez l'Assistant et ajoutez la référence à votre projet, puis réexécutez l'Assistant.
Entrez le nom du fichier d'icônes, le nom du modèle et la description du modèle et cliquez sur Terminer.
Si vous avez modifié un modèle existant, supprimez l'ancien fichier modèle .zip.

Une autre possibilité est de modifier manuellement le fichier .vstemplate pour ajouter des références au modèle d'élément.

Pour ajouter manuellement des références dans des modèles d'élément

Localisez le fichier .zip qui contient le modèle.
Extrayez le fichier .zip.
Ouvrez le fichier .vstemplate dans Visual Studio.
Dans l'élément TemplateContent, ajoutez un élément References.
Dans l'élément References, ajoutez un ou plusieurs éléments Reference qui contiendront les assemblys à référencer.

Dans chaque élément Reference, ajoutez un élément Assembly avec l'assembly à référencer. Par exemple :

<TemplateContent>
    <References>
        <Reference>
            <Assembly>
                System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
        <Reference>
            <Assembly>
                System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
    </References>
    ...
</TemplateContent>

Notes

Les assemblys doivent être référencés à l'aide de leurs noms forts.

Enregistrez et fermez le fichier .vstemplate.
Sélectionnez les fichiers inclus dans votre modèle, cliquez avec le bouton droit, sélectionnez Envoyer vers et cliquez sur Dossier compressé (dossier zippé). Les fichiers que vous avez sélectionnés sont compressés dans un fichier .zip.
Supprimez les fichiers de modèles extraits et l'ancien fichier .zip du modèle.
Placez le nouveau fichier .zip dans le même répertoire que le fichier .zip supprimé.