Configuration des fichiers .VsZ pour démarrer des Assistants
Les macros complémentaires Visual Studio sont déconseillées dans Visual Studio 2013. Vous devriez mettre vos macros complémentaires à niveau vers des extensions VSPackage. Pour plus d'informations sur les mises à jour, consultez FAQ : conversion de compléments en extensions VSPackage.
Visual Studio utilise un type de fichier appelé .vsz pour lancer les Assistants. Il s'agit de fichiers texte avec une extension .vsz que Visual Studio utilise pour déterminer l'Assistant à appeler et les informations à lui passer, si nécessaire.
Comparaison avec un fichier INI
Un fichier .vsz est une version simplifiée d'un fichier texte au format .ini, mais il ne comprend aucune section étiquetée. La première partie stocke les informations connues au sein de l'environnement Visual Studio. La deuxième section autorise la collecte de paramètres spécifiques à l'Assistant par l'environnement, et leur transmission à l'Assistant.
Vous trouverez ci-dessous un exemple de fichier .vsz :
VSWizard 8.0
Wizard=VIDWizard.CBlankSiteWizard
Param=<item1>
Param=<item2>
…
Notes
La valeur Assistant peut également consister en un GUID au format {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} — comprenant des sections de 8,4,4,4 et 12 caractères.
Le fichier présente ces différentes parties :
VSWizard — Il s'agit du numéro de version du format de fichier modèle, qui est « VSWizard 8.0 » pour Visual Studio. Aucun autre numéro n'est valide et l'utilisation de tout autre numéro entraînera une erreur "format non valide".
Wizard — Il s'agit de l'identificateur programmatique (ProgID), tel que MyWizard.MyClass, ou d'une représentation de chaîne GUID du CLSID de l'Assistant qui doit être co-créé par Visual Studio.
Param — Ces paramètres sont facultatifs et vous pouvez en ajouter autant que votre Assistant le requiert. Ils sont utilisés pour permettre au fichier .vsz de passer des paramètres personnalisés supplémentaires à l'Assistant. Chaque valeur est passée à l'Assistant en tant qu'élément de chaîne dans un tableau.
Voir aussi
Tâches
Procédure pas à pas : création d'un Assistant