Partager via


Implémentation de générateurs de fichier unique

Un outil personnalisé, parfois appelé générateur de fichiers unique, peut être utilisé pour étendre les systèmes de projet Visual Basic et Visual C# dans Visual Studio. Un outil personnalisé est un composant COM qui implémente l’interface IVsSingleFileGenerator . À l’aide de cette interface, un outil personnalisé transforme un fichier d’entrée unique en un seul fichier de sortie. Le résultat de la transformation peut être du code source ou toute autre sortie utile. Deux exemples de fichiers de code générés par des outils personnalisés sont générés en réponse aux modifications apportées au concepteur visuel et aux fichiers générés à l’aide du langage WSDL (Web Services Description Language).

Lorsqu’un outil personnalisé est chargé ou que le fichier d’entrée est enregistré, le système de projet appelle la Generate méthode et transmet une référence à une IVsGeneratorProgress interface de rappel, dans laquelle l’outil peut signaler sa progression à l’utilisateur.

Le fichier de sortie généré par l’outil personnalisé est ajouté au projet avec une dépendance sur le fichier d’entrée. Le système de projet détermine automatiquement le nom du fichier de sortie, en fonction de la chaîne retournée par l’implémentation de l’outil personnalisé de DefaultExtension.

Un outil personnalisé doit implémenter l’interface IVsSingleFileGenerator . Si vous le souhaitez, les outils personnalisés prennent en charge l’interface IObjectWithSite pour récupérer des informations à partir de sources autres que le fichier d’entrée. Dans tous les cas, avant de pouvoir utiliser un outil personnalisé, vous devez l’inscrire auprès du système ou dans le registre local Visual Studio. Pour plus d’informations sur l’inscription d’outils personnalisés, consultez Inscription de générateurs de fichiers uniques.