VSProjectItem.RunCustomTool-Methode
Startet das einem ProjectItem-Objekt zugeordnete benutzerdefinierte Tool. Ein benutzerdefiniertes Tool ist eine registrierte Komponente, mit der die IVsSingleFileGenerator-Schnittstelle implementiert wird. Benutzerdefinierte Tools sind mit Designern und Editoren vergleichbar.
Namespace: VSLangProj
Assembly: VSLangProj (in VSLangProj.dll)
Syntax
'Declaration
Sub RunCustomTool
void RunCustomTool()
void RunCustomTool()
abstract RunCustomTool : unit -> unit
function RunCustomTool()
Hinweise
Ein benutzerdefiniertes Tool erhält als Eingabe die von einem ProjectItem-Objekt dargestellte Datei und schreibt eine neue Datei, deren Name in der CustomToolOutput-Eigenschaft aufgeführt wird. Die RunCustomTool-Methode überwacht den Wert der CustomToolOutput-Eigenschaft wie folgt:
Wenn die CustomToolOutput-Eigenschaft leer ist, erstellt das Projektsystem einen passenden Dateinamen. Dieser beruht auf dem Namen des ProjectItem-Objekts, für das die RunCustomTool-Methode aufgerufen wurde.
Wenn die CustomToolOutput-Eigenschaft einen Wert aufweist, wird dieser vom Projektsystem verwendet.
Wenn die RunCustomTool-Methode nicht erfolgreich ausgeführt, d. h. ein Fehler in HRESULT ausgegeben wird, wird für die CustomToolOutput-Eigenschaft eine leere Zeichenfolge festgelegt.
Alle zuvor mit dem benutzerdefinierten Tool erstellten Projektelemente werden durch das von der RunCustomTool-Methode erstellte Projektelement ersetzt. Wenn das benutzerdefinierte Tool nicht erfolgreich ausgeführt wird, werden frühere, mit dem Tool erstellte Projektelemente aus dem Projekt entfernt.
Diese Methode kann erst aufgerufen werden, nachdem dem ProjectItem-Objekt ein benutzerdefiniertes Tool zugeordnet wurde. Legen Sie dazu die CustomTool-Eigenschaft des ProjectItem-Objekts fest. Die CustomTool-Eigenschaft erfordert den Programmbezeichner für das Tool.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.