VSProjectItem.RunCustomTool 方法
執行與 ProjectItem 物件有關聯的自訂工具。自訂工具是實作 IVsSingleFileGenerator 介面的已登錄元件。自訂工具與設計工具和編輯器類似。
命名空間: VSLangProj
組件: VSLangProj (在 vslangproj.dll 中)
語法
'宣告
'用途
備註
自訂工具會以 ProjectItem 代表的檔案為輸入資料,並寫入另一個新的檔案,其檔名列在 CustomToolOutput 屬性內。RunCustomTool 方法控制 CustomToolOutput 屬性值的狀況如下:
如果 CustomToolOutput 屬性是空白的,專案系統會依據先前叫用 RunCustomTool 方法所處理之 ProjectItem 物件的名稱建立適當的檔名。
如果 CustomToolOutput 屬性不是空白的,專案系統會使用現有值。
如果 RunCustomTool 方法未執行成功 (傳回的 HRESULT 中含有錯誤),則將 CustomToolOutput 屬性設定為空字串。
RunCustomTool 方法所建立的專案項目會取代任何之前由自訂工具建立的專案項目。如果自訂工具未成功執行,則會將之前由自訂工具建立的任何專案項目從專案移除。
呼叫這個方法之前,必須先設定 ProjectItem 物件的 CustomTool 屬性,使自訂工具與 ProjectItem 產生關聯。CustomTool 屬性需有工具的程式識別。