VSProjectItem.RunCustomTool, méthode

Exécute l'outil personnalisé associé à un objet ProjectItem. Un outil personnalisé est un composant inscrit qui implémente l'interface IVsSingleFileGenerator. Les outils personnalisés sont similaires aux Concepteurs et aux éditeurs.

Espace de noms: VSLangProj
Assembly : VSLangProj (dans vslangproj.dll)

Syntaxe

'Déclaration
'Utilisation

Notes

Un outil personnalisé accepte en entrée le fichier représenté par ProjectItem et écrit un nouveau fichier dont le nom est indiqué dans la propriété CustomToolOutput. La méthode RunCustomTool contrôle la valeur de la propriété CustomToolOutput comme suit :

• Si la propriété CustomToolOutput est vide, le système de projet crée un nom de fichier approprié ; ce nom est dérivé de celui de l'objet ProjectItem pour lequel la méthode RunCustomTool a été appelée.

• Si la propriété CustomToolOutput n'est pas vide, le système de projet utilise la valeur existante.

• Si la méthode RunCustomTool ne parvient pas à s'exécuter (si elle retourne une erreur dans HRESULT), la propriété CustomToolOutput a la valeur d'une chaîne vide.

• L'élément de projet créé par la méthode RunCustomTool remplace tout élément de projet précédemment créé par l'outil personnalisé. Si l'outil personnalisé ne parvient pas à s'exécuter, tous les éléments de projet qu'il a créés sont supprimés du projet.

Avant de pouvoir appeler cette méthode, vous devez associer un outil personnalisé à ProjectItem en définissant la propriété CustomTool de l'objet ProjectItem. La propriété CustomTool requiert l'identificateur de programme de l'outil.

Voir aussi

Référence

VSProjectItem, interface
Membres VSProjectItem
VSLangProj, espace de noms