VSProjectItem.RunCustomTool 方法

執行與 ProjectItem 物件有關聯的自訂工具。 自訂工具是實作 IVsSingleFileGenerator 介面的已登錄元件。 自訂工具與設計工具和編輯器類似。

命名空間:  VSLangProj
組件:  VSLangProj (在 VSLangProj.dll 中)

語法

'宣告
Sub RunCustomTool
void RunCustomTool()
void RunCustomTool()
abstract RunCustomTool : unit -> unit 
function RunCustomTool()

備註

自訂工具會以 ProjectItem 代表的檔案為輸入資料,並寫入另一個新的檔案,其檔名列在 CustomToolOutput 屬性內。 RunCustomTool 方法控制 CustomToolOutput 屬性值的狀況如下:

  • 如果 CustomToolOutput 屬性為空白,專案系統會依據先前叫用 RunCustomTool 方法所處理之 ProjectItem 物件的名稱建立適當的檔名。

  • 如果 CustomToolOutput 屬性不為空白,專案系統會使用現有值。

  • 如果 RunCustomTool 方法未執行成功 (傳回的 HRESULT 中含有錯誤),則將 CustomToolOutput 屬性設定為空字串。

  • RunCustomTool 方法所建立的專案項目會取代任何之前由自訂工具建立的專案項目。 如果自訂工具未成功執行,則會將之前由自訂工具建立的任何專案項目從專案移除。

呼叫這個方法之前,必須先設定 ProjectItem 物件的 CustomTool 屬性,使自訂工具與 ProjectItem 產生關聯。 CustomTool 屬性需要工具的程式識別項。

.NET Framework 安全性

請參閱

參考

VSProjectItem 介面

VSLangProj 命名空間