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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。