VSProjectItem.RunCustomTool, méthode
Mise à jour : novembre 2007
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
Sub RunCustomTool
Dim instance As VSProjectItem
instance.RunCustomTool()
void RunCustomTool()
void RunCustomTool()
function RunCustomTool()
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.
Autorisations
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.