Implémenter les générateurs de fichier unique
Un outil personnalisé (parfois appelée génération d'un générateur de fichier unique )peut être utilisé pour étendre Visual Basic et les systèmes de projet csprcs dans Visual Studio. un outil personnalisé est un composant COM qui implémente l'interface d' IVsSingleFileGenerator . Cette interface, un outil personnalisé fait un fichier d'entrée unique dans un fichier de sortie unique. Le résultat de la transformation peut être code source, ou toute autre sortie qui est utile. Deux exemples de fichiers de code outil-générés personnalisés sont le code généré en réponse à des modifications d'un concepteur visuel et les fichiers générés à l'aide de Web Services Description (WSDL) langage).
Lorsqu'un outil personnalisé est chargé, ou le fichier d'entrée est enregistré, le système de projet appelle la méthode d' Generate , et passe une référence à une interface de rappel d' IVsGeneratorProgress , par laquelle l'outil puisse stocker sa progression à l'utilisateur.
Le fichier de sortie que l'outil personnalisé génère l'erreur 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 personnalisée de l'outil d' DefaultExtension.
un outil personnalisé doit implémenter l'interface d' IVsSingleFileGenerator . Éventuellement, des outils personnalisés prennent en charge l'interface d' IObjectWithSite pour récupérer des informations sur les sources autres que le fichier d'entrée. Dans tous les cas, avant de pouvoir utiliser un outil personnalisé, vous devez l'inscrire dans le système ou le Registre locaux de Visual Studio . Pour plus d'informations sur l'inscription des outils personnalisés, consultez Stocker des générateurs de fichier unique.